<!doctype html>
<html>
<head>
<meta charset='UTF-8'><meta name='viewport' content='width=device-width initial-scale=1'>
<title>《vv音乐客户端接入接口sodnew》2.0</title></head>
<body><pre><code>`# 《VV音乐客户端接入接口sodnew》1.0
</code></pre>
<p>&nbsp;</p>
<h2>1、交易相关接口</h2>
<h3>1.1、查询乐币&amp;会员商品列表</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/prod/list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/prod/list.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>客户端类型</td><td>clientType</td><td>是</td><td>String(2)</td><td>1</td><td>客户端类型,android客户端传1,ios客户端传2,h5客户端传3</td></tr><tr><td>商品类型</td><td>payItemType</td><td>是</td><td>String(12)</td><td>300</td><td>商品类型,300:ios购买乐币,301:android购买vv乐币,303:H5购买vv乐币,350(android、ios)购买会员，360：新IOS会员列表</td></tr></tbody>
</table></figure>
<p>请求参数示例</p>
<pre><code>查询乐币：
安卓：{&quot;clientType&quot;:1,&quot;payItemType&quot;:301}
IOS：{&quot;clientType&quot;:2,&quot;payItemType&quot;:300}
查询会员：
安卓：{&quot;clientType&quot;:1,&quot;payItemType&quot;:350}
IOS：{&quot;clientType&quot;:2,&quot;payItemType&quot;:350}
</code></pre>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>商品列表</td><td>payItems</td><td>是</td><td>String</td><td>&nbsp;</td><td>返回json格式的商品列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;payItems&quot;: [
		{
            &quot;prodCount&quot;: 60, 
            &quot;price&quot;: 6, 
            &quot;payItemName&quot;: &quot;6元60乐币&quot;, 
            &quot;payDesc&quot;: &quot;60&quot;, 
            &quot;pyaItemType&quot;: &quot;602&quot;, 
            &quot;remarks&quot;: &quot;&quot;, 
            &quot;payItemId&quot;: &quot;6020001&quot;
        }, 
        {
            &quot;prodCount&quot;: 300, 
            &quot;price&quot;: 30, 
            &quot;payItemName&quot;: &quot;30元300乐币&quot;, 
            &quot;payDesc&quot;: &quot;300&quot;, 
            &quot;pyaItemType&quot;: &quot;602&quot;, 
            &quot;remarks&quot;: &quot;&quot;, 
            &quot;payItemId&quot;: &quot;6020002&quot;
        }
    ]
}
</code></pre>
<h5>商品模型 payItem</h5>
<pre><code>private String payItemID;       //商品编号
private String payItemName;     //商品名称
private String payItemType;     //商品类型
private BigDecimal price;       //商品价格
private Long prodCount;         //商品数量(原始数量+赠送数量)
private String payDesc;         //商品原始数量
private String remarks;         //商品赠送数量
...
</code></pre>
<h3>1.2、查询兑换档次列表</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/prod/el_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/prod/el_list.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>兑换档次列表</td><td>levelList</td><td>是</td><td>JsonArray</td><td>&nbsp;</td><td>返回json格式的兑换列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;levelList&quot;: [
        {
            &quot;remark&quot;: &quot;&quot;, 
            &quot;ticket&quot;: 100, 
            &quot;diamond&quot;: 58
        }
    ], 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h5>兑换档次模型 level</h5>
<pre><code>private Long ticket;            //音符数
private Long diamond;           //兑换乐币数
private String remark;          //备注
...
</code></pre>
<h3>1.3、APP购买下单</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/create4app.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/create4app.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>商品ID</td><td>payItemId</td><td>是</td><td>String(10)</td><td>0070002</td><td>商品ID</td></tr><tr><td>支付标识</td><td>payVendor</td><td>是</td><td>int</td><td>70</td><td>支付公司标识,52-微信APP支付,60-苹果支付,70-支付宝移动支付,72-支付宝wap支付</td></tr><tr><td>商品数量</td><td>prodCount</td><td>是</td><td>int</td><td>100</td><td>购买商品的数量</td></tr><tr><td>支付金额</td><td>payPrice</td><td>是</td><td>Number</td><td>100.01</td><td>需要支付的金额,单位元</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,10002:参数错误,13001:订单校验失败,13002:创建订单失败,13017:达到公测充值上限,不允许再充值,13018:其他原因,不允许充值,13019:被封账号,不允许充值</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>支付订单ID</td><td>payOrderId</td><td>是</td><td>String(32)</td><td>20160622094115001782</td><td>支付订单标识</td></tr><tr><td>支付标识</td><td>payVendor</td><td>是</td><td>int</td><td>70</td><td>支付公司标识,52-微信APP支付,60-苹果支付,70-支付宝移动支付,72-支付宝wap支付</td></tr><tr><td>支付参数</td><td>payParams</td><td>是</td><td>JSONObject</td><td>&nbsp;</td><td>客户端调用第三方支付的请求参数,当payVendor=52或70时,该值为json对象,客户端将该参数列表直接请求第三方支付系统,payVendor=60时该值为null</td></tr><tr><td>支付参数</td><td>payInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>将payParams用&amp;拼接</td></tr><tr><td>支付URL</td><td>payUrl</td><td>是</td><td>String</td><td>&nbsp;</td><td>当payVendor=72为wap支付时，该值为跳转到支付wap支付的地址</td></tr></tbody>
</table></figure>
<h5>请求微信APP支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;52&quot;, 
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;payOrderId&quot;: &quot;20160623101319001803&quot;, 
    &quot;payInfo&quot;: &quot;timestamp=1466648000&amp;sign=4398E10D018BA0F3B8CB5C1215BDCDC3&amp;partnerid=1340831501&amp;noncestr=gl9xobhmeu66yr28p4h22fzyrmq23w2o&amp;prepayid=wx2016062310132042944fe5d80648655865&amp;package=Sign=WXPay&amp;appid=wx34d5660accfcf6ae&quot;, 
    &quot;retMsg&quot;: &quot;成功&quot;, 
    &quot;payUrl&quot;:null, 
    &quot;payParams&quot;: {
        &quot;timestamp&quot;: 1466648000, 
        &quot;sign&quot;: &quot;4398E10D018BA0F3B8CB5C1215BDCDC3&quot;, 
        &quot;partnerid&quot;: &quot;1340831501&quot;, 
        &quot;noncestr&quot;: &quot;gl9xobhmeu66yr28p4h22fzyrmq23w2o&quot;, 
        &quot;prepayid&quot;: &quot;wx2016062310132042944fe5d80648655865&quot;, 
        &quot;package&quot;: &quot;Sign=WXPay&quot;, 
        &quot;appid&quot;: &quot;wx34d5660accfcf6ae&quot;
    }
}
</code></pre>
<h5>请求苹果支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;60&quot;, 
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;payOrderId&quot;: &quot;20160623102617001804&quot;, 
    &quot;payInfo&quot;: &quot;null&quot;, 
    &quot;retMsg&quot;: &quot;成功&quot;, 
    &quot;payUrl&quot;:null, 
    &quot;payParams&quot;: null
}
</code></pre>
<h5>请求支付宝移动支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;70&quot;, 
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;payOrderId&quot;: &quot;20160622173836001802&quot;, 
    &quot;payInfo&quot;: &quot;sign=LMOyrTsIVenDrTMLefQoy5odwbD0FtGKY00g1BF5zYIbc0RXEMPOVDA94GC0dYYSQbEoxbYw46KP4nqQ+HChLDAZQU+nke+Ap7lfXWU4r5aPxX6JiKv2w4xsujV7dbmBkVstpC7hQzp56CGPdRmg1l11Yr+pATWPVhnXnvWUrPQ=&amp;body=订单测试&amp;_input_charset=utf-8&amp;subject=30万V点&amp;total_fee=0.01&amp;sign_type=RSA&amp;service=mobile.securitypay.pay¬ify_url=https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&amp;partner=2088701346480898&amp;seller_id=vv@mail.51vv.com&amp;out_trade_no=20160622173836001802&amp;payment_type=1&quot;, 
    &quot;retMsg&quot;: &quot;成功&quot;, 
    &quot;payUrl&quot;:null, 
    &quot;payParams&quot;: {
        &quot;sign&quot;: &quot;LMOyrTsIVenDrTMLefQoy5odwbD0FtGKY00g1BF5zYIbc0RXEMPOVDA94GC0dYYSQbEoxbYw46KP4nqQ+HChLDAZQU+nke+Ap7lfXWU4r5aPxX6JiKv2w4xsujV7dbmBkVstpC7hQzp56CGPdRmg1l11Yr+pATWPVhnXnvWUrPQ=&quot;, 
        &quot;body&quot;: &quot;订单测试&quot;, 
        &quot;_input_charset&quot;: &quot;utf-8&quot;, 
        &quot;subject&quot;: &quot;30万V点&quot;, 
        &quot;total_fee&quot;: &quot;0.01&quot;, 
        &quot;sign_type&quot;: &quot;RSA&quot;, 
        &quot;service&quot;: &quot;mobile.securitypay.pay&quot;, 
        &quot;notify_url&quot;: &quot;https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&quot;, 
        &quot;partner&quot;: &quot;2088701346480898&quot;, 
        &quot;seller_id&quot;: &quot;vv@mail.51vv.com&quot;, 
        &quot;out_trade_no&quot;: &quot;20160622173836001802&quot;, 
        &quot;payment_type&quot;: &quot;1&quot;
    }
}
</code></pre>
<h5>请求支付宝WAP支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;72&quot;, 
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;payOrderId&quot;: &quot;pay2016090913053608091287376&quot;, 
    &quot;payInfo&quot;: &quot;subject=6元60乐币&amp;sign_type=RSA¬ify_url=https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&amp;out_trade_no=pay2016090913053608091287376&amp;return_url=http://localhost:8080/vv-live-trans/order/pay_notify.htm&amp;sign=W3T63eMzpE%2BQW7%2FqkWVVq6dTYe8yDo9%2Bp2jF6F4iBaGPlQ7BdE%2BFnZbi2a16dhhoZ20yZI5xfajSWKC%2FCeJWphi0xmgoE2fQVF4a4euKswpBxf5xMTW%2FHGtx6ZXgmmfTIqr64YLku1pFpCZlXQbcH%2BPapWhfOWcPigznigxbTgk%3D&amp;app_pay=Y&amp;_input_charset=utf-8&amp;total_fee=6.00&amp;service=alipay.wap.create.direct.pay.by.user&amp;seller_id=2088701346480898&amp;partner=2088701346480898&amp;payment_type=1&amp;show_url=http://www.51vv.com&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;, 
    &quot;payUrl&quot;: &quot;https://mapi.alipay.com/gateway.do?_input_charset=utf-8&amp;app_pay=Y¬ify_url=https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&amp;out_trade_no=pay2016090913053608091287376&amp;partner=2088701346480898&amp;payment_type=1&amp;return_url=http://localhost:8080/vv-live-trans/order/pay_notify.htm&amp;seller_id=2088701346480898&amp;service=alipay.wap.create.direct.pay.by.user&amp;show_url=http://www.51vv.com&amp;sign=W3T63eMzpE%2BQW7%2FqkWVVq6dTYe8yDo9%2Bp2jF6F4iBaGPlQ7BdE%2BFnZbi2a16dhhoZ20yZI5xfajSWKC%2FCeJWphi0xmgoE2fQVF4a4euKswpBxf5xMTW%2FHGtx6ZXgmmfTIqr64YLku1pFpCZlXQbcH%2BPapWhfOWcPigznigxbTgk%3D&amp;sign_type=RSA&amp;subject=6元60乐币&amp;total_fee=6.00&quot;, 
    &quot;payParams&quot;: {
        &quot;subject&quot;: &quot;6元60乐币&quot;, 
        &quot;sign_type&quot;: &quot;RSA&quot;, 
        &quot;notify_url&quot;: &quot;https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&quot;, 
        &quot;out_trade_no&quot;: &quot;pay2016090913053608091287376&quot;, 
        &quot;return_url&quot;: &quot;http://localhost:8080/vv-live-trans/order/pay_notify.htm&quot;, 
        &quot;sign&quot;: &quot;W3T63eMzpE%2BQW7%2FqkWVVq6dTYe8yDo9%2Bp2jF6F4iBaGPlQ7BdE%2BFnZbi2a16dhhoZ20yZI5xfajSWKC%2FCeJWphi0xmgoE2fQVF4a4euKswpBxf5xMTW%2FHGtx6ZXgmmfTIqr64YLku1pFpCZlXQbcH%2BPapWhfOWcPigznigxbTgk%3D&quot;, 
        &quot;app_pay&quot;: &quot;Y&quot;, 
        &quot;_input_charset&quot;: &quot;utf-8&quot;, 
        &quot;total_fee&quot;: &quot;6.00&quot;, 
        &quot;service&quot;: &quot;alipay.wap.create.direct.pay.by.user&quot;, 
        &quot;seller_id&quot;: &quot;2088701346480898&quot;, 
        &quot;partner&quot;: &quot;2088701346480898&quot;, 
        &quot;payment_type&quot;: &quot;1&quot;, 
        &quot;show_url&quot;: &quot;http://www.51vv.com&quot;
    }
}
</code></pre>
<h3>1.4、H5购买下单</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/create4H5.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/create4H5.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>是</td><td>Long</td><td>10000</td><td>用户Id</td></tr><tr><td>用户openId</td><td>openId</td><td>是</td><td>String</td><td>o2RvowBf7sOVJf8kJksUEMceaDqo</td><td>用户在微信公众号的openId</td></tr><tr><td>商品ID</td><td>payItemId</td><td>是</td><td>String(10)</td><td>0070002</td><td>商品ID</td></tr><tr><td>支付标识</td><td>payVendor</td><td>是</td><td>int</td><td>70</td><td>支付公司标识,50-微信公众号支付</td></tr><tr><td>商品数量</td><td>prodCount</td><td>是</td><td>int</td><td>100</td><td>购买商品的数量</td></tr><tr><td>支付金额</td><td>payPrice</td><td>是</td><td>Number</td><td>100.01</td><td>需要支付的金额,单位元</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,10002:参数错误,13001:订单校验失败,13002:创建订单失败,13017:达到公测充值上限,不允许再充值,13018:其他原因,不允许充值,13008:用户没有登录,13019:被封账号,不允许充值</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>支付订单ID</td><td>payOrderId</td><td>是</td><td>String(32)</td><td>20160622094115001782</td><td>支付订单标识</td></tr><tr><td>支付标识</td><td>payVendor</td><td>是</td><td>int</td><td>70</td><td>支付公司标识,52-微信APP支付,60-苹果支付,70-支付宝移动支付</td></tr><tr><td>支付参数</td><td>payParams</td><td>是</td><td>JSONObject</td><td>&nbsp;</td><td>客户端调用第三方支付的请求参数,当payVendor=52或70时,该值为json对象,客户端将该参数列表直接请求第三方支付系统,payVendor=60时该值为null</td></tr><tr><td>支付参数</td><td>payInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>将payParams用&amp;拼接</td></tr></tbody>
</table></figure>
<h5>请求微信APP支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;50&quot;, 
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;payOrderId&quot;: &quot;2016070621064862393016404&quot;, 
    &quot;payInfo&quot;: &quot;appId=wxdeac257714869939&amp;timeStamp=1467810439&amp;signType=MD5&amp;package=prepay_id=wx201607062107199bf62379df0668805968&amp;nonceStr=w86wxst7xu9m2jckytjklzwzq23ausq3&amp;paySign=AB60DD8D81C9F92C4870AAAA431A91FF&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;, 
    &quot;payParams&quot;: {
        &quot;appId&quot;: &quot;wxdeac257714869939&quot;, 
        &quot;timeStamp&quot;: 1467810439, 
        &quot;signType&quot;: &quot;MD5&quot;, 
        &quot;package&quot;: &quot;prepay_id=wx201607062107199bf62379df0668805968&quot;, 
        &quot;nonceStr&quot;: &quot;w86wxst7xu9m2jckytjklzwzq23ausq3&quot;, 
        &quot;paySign&quot;: &quot;AB60DD8D81C9F92C4870AAAA431A91FF&quot;
    }
}
</code></pre>
<h3>1.5、苹果支付验凭证</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/iap_notify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/iap_notify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>支付订单ID</td><td>payOrderId</td><td>是</td><td>String(32)</td><td>20160622094115001782</td><td>支付订单标识</td></tr><tr><td>凭证数据</td><td>receiptData</td><td>是</td><td>String</td><td>&nbsp;</td><td>苹果支付凭证</td></tr><tr><td>交易单号</td><td>transactionId</td><td>是</td><td>String(32)</td><td>2016070120017640321</td><td>苹果支付交易单号</td></tr><tr><td>签名数据</td><td>sign</td><td>是</td><td>String(32)</td><td>182964b72c27b0452d3a2b3bee3d4409</td><td>签名数据,与服务端协商生产</td></tr><tr><td>补单标识</td><td>needRepairPayOrder</td><td>是</td><td>Integer</td><td>1</td><td>补单标识，为1时表示需要补单，payOrderId为客户端生成的一个临时订单号（不可用）；为0时表示不需要补单，payOrderId为真正的支付订单号</td></tr><tr><td>商品ID</td><td>payItemID</td><td>是</td><td>String(32)</td><td>3010002</td><td>商品ID，如果needRepairPayOrder为1时需要该参数找到对应的支付订单号执行补单策略，needRepairPayOrder为0时表示不需要执行补单策略</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>创建时间</td><td>createTime</td><td>是</td><td>Long</td><td>&nbsp;</td><td>订单创建时间</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: 1000, 
    &quot;retMsg&quot;: &quot;success&quot;, 
    &quot;createTime&quot;: &quot;1467092070782&quot;
}
</code></pre>
<h3>1.6、查询订单</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/query.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>客户端类型</td><td>clientType</td><td>否</td><td>String</td><td>h5</td><td>客户端类型：ios,android,pc,h5,web,wap（h5、web、wap不需要认证用户）</td></tr><tr><td>支付订单ID</td><td>payOrderId</td><td>是</td><td>String(32)</td><td>20160622094115001782</td><td>支付订单标识</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>支付用户ID</td><td>payUserID</td><td>是</td><td>long</td><td>70000069</td><td>支付付款的用户ID</td></tr><tr><td>获得商品用户ID</td><td>userID</td><td>是</td><td>long</td><td>70000069</td><td>获得商品的用户ID</td></tr><tr><td>支付金额</td><td>payPrice</td><td>是</td><td>Number</td><td>6</td><td>需要支付的金额,单位元</td></tr><tr><td>商品数量</td><td>payItemCount</td><td>是</td><td>int</td><td>60</td><td>获得商品的数量</td></tr><tr><td>订单状态</td><td>status</td><td>是</td><td>int</td><td>1</td><td>订单状态，订单生成(0),支付成功(1),处理完成(2),处理失败(-1)</td></tr></tbody>
</table></figure>
<h5>请求微信扫码支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;, 
    &quot;payUserID&quot;: 70000069, 
    &quot;userID&quot;: 70000069, 
    &quot;payPrice&quot;: 6, 
    &quot;status&quot;: 0, 
    &quot;payItemCount&quot;: 60
}
</code></pre>
<h3>1.7、查询购买明细</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/list.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>商品类型</td><td>payType</td><td>否</td><td>Integer</td><td>1</td><td>商品类型(1:乐币,2:会员)</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>创建时间</td><td>transList</td><td>是</td><td>JSONArray</td><td>&nbsp;</td><td>明细列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;transList&quot;: [
        {
            &quot;id&quot;: 201608210001, 
            &quot;userID&quot;: 1000006, 
	        &quot;nickName&quot;: &quot;&quot;,   // 收礼人昵称
            &quot;createTime&quot;: 1467630205000, 
            &quot;payOrderId&quot;: &quot;2016070419043138052096390&quot;, 
            &quot;payPrice&quot;: 6, 
            &quot;state&quot;: 1, 
            &quot;payItemCount&quot;: 1, 
            &quot;totalItemCount&quot;: 60, 
            &quot;businessID&quot;: &quot;0000020000&quot;, 
            &quot;payItemID&quot;: &quot;6020001&quot;, 
            &quot;payUserId&quot;: 1000006, 
            &quot;payType&quot;: &quot;1&quot;  // 充值乐币
        }, 
        {
            &quot;id&quot;: 201608210002, 
            &quot;userID&quot;: 1000006, 
	         &quot;nickName&quot;: &quot;&quot;,   // 收礼人昵称
            &quot;createTime&quot;: 1467630498000, 
            &quot;payOrderId&quot;: &quot;2016070419085421748902727&quot;, 
            &quot;payPrice&quot;: 6, 
            &quot;state&quot;: 1, 
            &quot;payItemCount&quot;: 1, 
            &quot;totalItemCount&quot;: 1, 
            &quot;businessID&quot;: &quot;0000020000&quot;, 
            &quot;payItemID&quot;: &quot;6020001&quot;, 
            &quot;payUserId&quot;: 1000006, 
            &quot;payType&quot;: &quot;2&quot;  // 购买会员
        }
    ], 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h5>明细模型 trans</h5>
<pre><code>private Long userID;            //用户编号
private Long createTime;        //创建时间
private String payOrderId;      //支付订单编号
private BigDecimal payPrice;    //支付金额
private Integer state;          //状态
private Integer payItemCount;   //项目数量
private Integer totalItemCount; //商品数量
private String businessID;      //业务订单编号
private String payItemID;       //商品编号
private Long payUserId;         //支付用户编号
private String payType;         //商品类型(1:乐币,2:会员)
...
</code></pre>
<h3>1.8、申请提现    </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/apply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/apply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>金额</td><td>amount</td><td>是</td><td>Number</td><td>100.00</td><td>单位元</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,13010:音符余额不足,13013:已超出今日领取限额,13014:超出今日提现次数上限,13015:领取金额必须为整数且不少于10元,13006:用户没有绑定微信,13007:用户没有实名认证，13016:其他原因失败</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.9、兑换乐币  </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/exchange.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/exchange.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>音符</td><td>ticket</td><td>是</td><td>Long</td><td>380</td><td>音符数量</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,13010:您的音符数量不足,13011:账户锁定不可以兑换,13012:其他原因兑换失败,13021:至少需要2音符</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.10、查询提现记录和兑换记录</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/withdraw_exchange_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/withdraw_exchange_list.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>否</td><td>Long</td><td>10000</td><td>用户Id</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>提现和兑换记录</td><td>withdrawExchangeList</td><td>是</td><td>JsonArray</td><td>&nbsp;</td><td>返回json格式的兑换列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;withdrawList&quot;: [
        {
            &quot;id&quot;: 201608210001, 
            &quot;amount&quot;: 100, 
            &quot;time&quot;: 1467630498000, 
            &quot;remark&quot;: &quot;&quot;, 
            &quot;ticket&quot;: 380,
            &quot;state&quot;: 1,
            &quot;stateStr&quot;: &quot;正在处理&quot;,   // 结算状态.提交(0),提现中(1),提现成功(2),提现失败(-1)
            &quot;type&quot;:　1 ，              // 提现
            &quot;bankState&quot;;&quot;已提现&quot;，   //银行卡提现状态
            &quot;bankInfo&quot; ; &quot;5月15号提现&quot;    //银行卡提现信息展示

        }, 
        {
            &quot;id&quot;: 201608210002, 
            &quot;time&quot;: 1467630498000, 
            &quot;remark&quot;: &quot;&quot;, 
            &quot;ticket&quot;: 380, 
            &quot;diamond&quot;: 100,
            &quot;type&quot;:　2               // 兑换
            &quot;bankState&quot;;&quot;已提现&quot;，   //银行卡提现状态
            &quot;bankInfo&quot; ; &quot;5月15号提现&quot;    //银行卡提现信息展示
        }
    ], 
    &quot;retMsg&quot;: &quot;success&quot;
}

</code></pre>
<h5>提现和兑换记录模型 withdrawExchange</h5>
<pre><code>private Integer amount;         //乐币数量
private String time;            //提现时间
private String remark;          //备注
private Integer ticket;         //音符数量
private Integer state;          //状态
private String stateStr;        //状态字符串
private Integer type;           //类型(1:提现,2:兑换)
...
</code></pre>
<h3>1.11、查询累计提现金额和兑换数量       </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/account.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/account.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000表示提交成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;totalWithdrawAmount&quot;: 1028,    //提现金额
    &quot;totalExchangeDiamond&quot;: 800,    //兑换数量
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.12、查询用户当日剩余可提现金额     </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/amt_day.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/amt_day.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,13006:用户没有绑定微信,13007:用户没有实名认证，13016:其他原因失败</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>金额</td><td>amt_day</td><td>是</td><td>Number</td><td>480</td><td>当日剩余可提现金额，单位元</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;amt_day&quot;: 480, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.13、查询用户音符余额和可提现金额  </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/info.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/info.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| ------- </p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>音符数</td><td>ticketCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户的音符数</td></tr><tr><td>可提现金额</td><td>amount</td><td>是</td><td>Number</td><td>&nbsp;</td><td>单位元</td></tr><tr><td>提现比例</td><td>exchangeRate</td><td>是</td><td>String</td><td>&nbsp;</td><td>人民币兑音符比例描述</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;amount&quot;: 3333010.8, 
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;exchangeRate&quot;: &quot;人民币兑音符1:12，返现比例:40.00%&quot;, 
    &quot;ticketCount&quot;: 99990324, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.14、计算提现金额所需音符数 </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/amount2Ticket.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/amount2Ticket.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>提现金额</td><td>amount</td><td>是</td><td>Number</td><td>100.00</td><td>金额,单位元</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>音符</td><td>ticket</td><td>是</td><td>Long</td><td>&nbsp;</td><td>需要的音符数</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;ticket&quot;: 1314, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.15、计算音符可以兑换乐币数   </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/ticket2Diamond.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/ticket2Diamond.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>音符</td><td>ticket</td><td>是</td><td>Long</td><td>100</td><td>音符数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>乐币数</td><td>diamond</td><td>是</td><td>Long</td><td>&nbsp;</td><td>可兑换的乐币数</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;diamond&quot;: 158, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.16、查询乐币品列表(IOS马甲)</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/prod/list_ios.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/prod/list_ios.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<p>说明:通过app的名称和版本返回列表</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>商品列表</td><td>payItems</td><td>是</td><td>String</td><td>&nbsp;</td><td>返回json格式的商品列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;,
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;payItems&quot;: [
		{
            &quot;prodCount&quot;: 60,
            &quot;price&quot;: 6,
            &quot;payItemName&quot;: &quot;6元60乐币&quot;,
            &quot;payDesc&quot;: &quot;60&quot;,
            &quot;pyaItemType&quot;: &quot;602&quot;,
            &quot;remarks&quot;: &quot;&quot;,
            &quot;payItemId&quot;: &quot;6020001&quot;
        },
        {
            &quot;prodCount&quot;: 300,
            &quot;price&quot;: 30,
            &quot;payItemName&quot;: &quot;30元300乐币&quot;,
            &quot;payDesc&quot;: &quot;300&quot;,
            &quot;pyaItemType&quot;: &quot;602&quot;,
            &quot;remarks&quot;: &quot;&quot;,
            &quot;payItemId&quot;: &quot;6020002&quot;
        }
    ]
}
</code></pre>
<h5>商品模型 payItem</h5>
<pre><code>private String payItemID;       //商品编号
private String payItemName;     //商品名称
private String payItemType;     //商品类型
private BigDecimal price;       //商品价格
private Long prodCount;         //商品数量(原始数量+赠送数量)
private String payDesc;         //商品原始数量
private String remarks;         //商品赠送数量
...
</code></pre>
<h3>1.17、根据主键ID删除购买记录（充值记录、购买记录）</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/deleteBuyOrderByID.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/deleteBuyOrderByID.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>订单Id</td><td>id</td><td>是</td><td>Long</td><td>10000</td><td>订单Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>删除结果</td><td>count</td><td>否</td><td>int</td><td>1</td><td>1为删除成功</td></tr></tbody>
</table></figure>
<h3>1.18、根据主键ID删除用户提现记录或用户兑换记录（领取记录）</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/deleteUserDrawOrUserExchangeByID.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/deleteUserDrawOrUserExchangeByID.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>记录Id</td><td>id</td><td>是</td><td>Long</td><td>10000</td><td>记录Id</td></tr><tr><td>记录类型</td><td>type</td><td>是</td><td>int</td><td>1</td><td>记录类型：1:提现记录 2:兑换记录</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>删除结果</td><td>count</td><td>否</td><td>int</td><td>1</td><td>1为删除成功</td></tr></tbody>
</table></figure>
<h3>1.19、Web购买下单（为他人充值）</h3>
<h5>接口作者：张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/order/create4web.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/order/create4web.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>客户端类型</td><td>clientType</td><td>否</td><td>String</td><td>web</td><td>客户端类型：pc,web,wap</td></tr><tr><td>用户Id</td><td>userId</td><td>否</td><td>Long</td><td>10000</td><td>外部用户Id（clientType为web或wap时，该参数必填）</td></tr><tr><td>为他人下单用户Id</td><td>toUserId</td><td>否</td><td>Long</td><td>10001</td><td>为他人充值用户Id（不传默认为userId为自己下单）</td></tr><tr><td>商品ID</td><td>payItemId</td><td>是</td><td>String(10)</td><td>0070002</td><td>商品ID</td></tr><tr><td>支付标识</td><td>payVendor</td><td>是</td><td>int</td><td>70</td><td>支付公司标识,51-微信扫码支付,52-微信APP支付,71-支付宝扫码支付,72-支付宝wap支付</td></tr><tr><td>商品数量</td><td>prodCount</td><td>是</td><td>int</td><td>100</td><td>购买商品的数量</td></tr><tr><td>支付金额</td><td>payPrice</td><td>是</td><td>Number</td><td>100.01</td><td>需要支付的金额,单位元</td></tr><tr><td>二维码图片宽度</td><td>imgWidth</td><td>否</td><td>int</td><td>150</td><td>默认200</td></tr><tr><td>二维码图片高度</td><td>imgHeight</td><td>否</td><td>int</td><td>150</td><td>默认200</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,0:成功,10002:参数错误,13001:订单校验失败,13002:创建订单失败,13017:达到公测充值上限,不允许再充值,13018:其他原因,不允许充值,13019:被封账号,不允许充值</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在result为0的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>支付订单ID</td><td>payOrderId</td><td>是</td><td>String(32)</td><td>20160622094115001782</td><td>支付订单标识</td></tr><tr><td>支付标识</td><td>payVendor</td><td>是</td><td>int</td><td>51</td><td>支付公司标识,51-微信扫码支付,52-微信APP支付,71-支付宝扫码支付,72-支付宝wap支付</td></tr><tr><td>二维码URL</td><td>codeUrl</td><td>否</td><td>String</td><td>&nbsp;</td><td>返回第三方系统生成的二维码URL，当payVendor=51时该值不为空</td></tr><tr><td>支付URL</td><td>payUrl</td><td>否</td><td>String</td><td>&nbsp;</td><td>跳转第三方支付URL地址，当payVendor=72时该值不为空</td></tr></tbody>
</table></figure>
<h5>请求微信扫码支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;51&quot;, 
    &quot;result&quot;: &quot;0&quot;, 
    &quot;payOrderId&quot;: &quot;pay2016072818071616730450380&quot;, 
    &quot;codeUrl&quot;: &quot;weixin://wxpay/bizpayurl?pr=nNPFE4T&quot;, 
    &quot;resMsg&quot;: &quot;success&quot;
}
</code></pre>
<h5>请求微信APP支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;52&quot;, 
    &quot;result&quot;: &quot;0&quot;, 
    &quot;payOrderId&quot;: &quot;pay2016090913152183079822254&quot;, 
    &quot;resMsg&quot;: &quot;success&quot;, 
    &quot;payParams&quot;: {
        &quot;timestamp&quot;: 1473398122, 
        &quot;sign&quot;: &quot;9695C45FCC75E9B65EEB4D121BD567A9&quot;, 
        &quot;partnerid&quot;: &quot;1367655402&quot;, 
        &quot;noncestr&quot;: &quot;9siupfqajpwukd3czgch0npixtj4d1lq&quot;, 
        &quot;prepayid&quot;: &quot;wx20160909131522701c86e25f0399588603&quot;, 
        &quot;package&quot;: &quot;Sign=WXPay&quot;, 
        &quot;appid&quot;: &quot;wxa095d1d71c33c151&quot;
    }
}
</code></pre>
<h5>请求支付宝扫码支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;71&quot;, 
    &quot;result&quot;: &quot;0&quot;, 
    &quot;payOrderId&quot;: &quot;pay2016090913165023771840841&quot;, 
    &quot;codeImgUrl&quot;: &quot;https://mapi.alipay.com/gateway.do?_input_charset=utf-8&amp;body=商品6030007¬ify_url=https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&amp;out_trade_no=pay2016090913165023771840841&amp;partner=2088701346480898&amp;payment_type=1&amp;qr_pay_mode=4&amp;qrcode_width=100&amp;return_url=http://localhost:8080/vv-live-trans/order/pay_notify.htm&amp;seller_id=2088701346480898&amp;service=create_direct_pay_by_user&amp;sign=RXeI9VqgBGT1%2BowzuZpGPEgacDSSLOj0E5XciB3M5Q%2FDWMBxPleVli3AFB%2FO7hSI7yQVFYtJa%2Bx39%2FW56Mbmry8yRkKtxaBWdcDr9vudGXIplhdHN6p8DhqBXQET0SbrzJx80m5CAq2X1ou4fJwT5LQf7acFd0ZKnhUEy8Adkkc%3D&amp;sign_type=RSA&amp;subject=test4&amp;total_fee=0.01&quot;, 
    &quot;resMsg&quot;: &quot;success&quot;
}
</code></pre>
<h5>请求支付宝WAP支付返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;payVendor&quot;: &quot;72&quot;, 
    &quot;result&quot;: &quot;0&quot;, 
    &quot;payOrderId&quot;: &quot;pay2016090913180853044365991&quot;, 
    &quot;resMsg&quot;: &quot;success&quot;, 
    &quot;payUrl&quot;: &quot;https://mapi.alipay.com/gateway.do?_input_charset=utf-8&amp;app_pay=Y¬ify_url=https://vvpay.51vv.com/paytest/notify/aliPayNotifyRes.htm&amp;out_trade_no=pay2016090913180853044365991&amp;partner=2088701346480898&amp;payment_type=1&amp;return_url=http://localhost:8080/vv-live-trans/order/pay_notify.htm&amp;seller_id=2088701346480898&amp;service=alipay.wap.create.direct.pay.by.user&amp;show_url=http://www.51vv.com&amp;sign=LxJacL4MZrMivD06SX%2F8c8h4YGCY8crQUdktoBgHTg3%2FvYhRE9MzuIEZrqH5tMC1G2s9jDsigM8ZNHcwhg2YwF5v8aK0aOLjVfvD0I5tmMZTgXCmfKjRqHXqKGrl6oybdV6U34Wm1LhePmcUOhaJCVkurBSXvRx72fs9WLwtiDw%3D&amp;sign_type=RSA&amp;subject=test4&amp;total_fee=0.01&quot;
}
</code></pre>
<h3>1.20、根据price查询对应的乐币及赠送乐币</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/prod/getMusicNum.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/prod/getMusicNum.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>自定义价格</td><td>price</td><td>是</td><td>int</td><td>298</td><td>自定义价格</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>乐币对象</td><td>payItem</td><td>是</td><td>Object</td><td>&nbsp;</td><td>返回json格式的乐币对象</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
  &quot;retCode&quot;: &quot;1000&quot;,
  &quot;payItem&quot;: {
    &quot;payItemID&quot;: &quot;3050001&quot;,
    &quot;payItemName&quot;: &quot;19.88元1988乐币&quot;,
    &quot;payItemType&quot;: null,
    &quot;price&quot;: 19.88,
    &quot;prodCount&quot;: 1988,
    &quot;payDesc&quot;: &quot;1988&quot;,
    &quot;remarks&quot;: null
  },
  &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h5>乐币对象模型 level</h5>
<pre><code>private String payItemID;         //商品编号
private String payItemName;       //商品名称
private BigDecimal price;         //商品价格
private Long prodCount;           //商品数量(原始数量+赠送数量)
private String payDesc;           //商品原始数量
private String remarks;           //商品原始数量
...
</code></pre>
<h3>1.21、我的任务列表(首页是否显示红点提醒)</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/task/myTaskInfoView.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/myTaskInfoView.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>900004830</td><td>用户id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>提醒未领取任务状态</td><td>viewState</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>返回json格式的任务对象</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: &quot;1000&quot;,
	&quot;retMsg&quot;: &quot;success&quot;,
	&quot;viewState&quot;: true
	&quot;bubbleShow&quot;:0, 0代表需要展示气泡,1代表不需要展示气泡
}
</code></pre>
<h5>对象模型 </h5>
<pre><code>private Boolean viewState;         // true:显示；false:不显示
...
</code></pre>
<h3>1.211、是否显示手机绑定任务入口</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/task/bindPhoneOpen.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/bindPhoneOpen.htm</a></p>
<h5>是否鉴权：是</h5>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>是否显示任务入口</td><td>openFlag</td><td>是</td><td>int</td><td>&nbsp;</td><td>1：显示入口，非1不显示</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: &quot;1000&quot;,
	&quot;retMsg&quot;: &quot;success&quot;,
	&quot;openFlag&quot;: 1
}
</code></pre>
<h3>1.212 绑定手机号后领取鲜花</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/task/addBindFlowers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/addBindFlowers.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表 非1000加花失败</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
 &quot;retCode&quot;: &quot;1000&quot;,
 &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.22、我的任务列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/task/myTaskInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/myTaskInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>900004830</td><td>用户id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>任务对象</td><td>myTaskInfo</td><td>是</td><td>Object</td><td>&nbsp;</td><td>返回json格式的任务对象</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
  &quot;retCode&quot;: &quot;1000&quot;,
  &quot;retMsg&quot;: &quot;success&quot;,
  &quot;myTaskInfo&quot;: {
    &quot;signRecords&quot;: [
      {
        &quot;taskID&quot;: 10001,
        &quot;taskType&quot;: 1,
        &quot;taskName&quot;: &quot;每日签到&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 3,
        &quot;vipAwardFlower&quot;: 15,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;签到得3朵鲜花，贵族/会员额外获得12朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: null,
        &quot;tasFinishkRate&quot;: null,
        &quot;awardCount&quot;: null,
        &quot;awardFinishCount&quot;: null
      }
    ],
    &quot;taskRecords&quot;: [
      {
        &quot;taskID&quot;: 20002,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;分享直播&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 3,
        &quot;vipAwardFlower&quot;: 6,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;分享直播到站外，可领取3朵鲜花，贵族/会员额外再多领3朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: 0,
        &quot;tasFinishkRate&quot;: 1,
        &quot;awardCount&quot;: 1,
        &quot;awardFinishCount&quot;: 0
      },
      {
        &quot;taskID&quot;: 20003,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;分享歌房&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 3,
        &quot;vipAwardFlower&quot;: 6,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;分享歌房到站外，可领取3朵鲜花，贵族/会员额外再多领3朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: null,
        &quot;tasFinishkRate&quot;: null,
        &quot;awardCount&quot;: null,
        &quot;awardFinishCount&quot;: null
      },
      {
        &quot;taskID&quot;: 20004,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;评论作品&quot;,
        &quot;taskMode&quot;: 1,
        &quot;taskLimit&quot;: 10,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 30,
        &quot;vipAwardFlower&quot;: 60,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;评论喜欢的作品，可领取30朵鲜花，贵族/会员额外再多领30朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: 0,
        &quot;tasFinishkRate&quot;: 3,
        &quot;awardCount&quot;: 10,
        &quot;awardFinishCount&quot;: 0
      },
      {
        &quot;taskID&quot;: 20006,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;赠送礼物&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 3,
        &quot;vipAwardFlower&quot;: 6,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;给喜欢的作品赠送礼物或者鲜花，可领取3朵鲜花，贵族/会员额外再多领3朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: null,
        &quot;tasFinishkRate&quot;: null,
        &quot;awardCount&quot;: null,
        &quot;awardFinishCount&quot;: null
      },
      {
        &quot;taskID&quot;: 20007,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;参与合唱&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 15,
        &quot;vipAwardFlower&quot;: 25,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;发布一首合唱作品，可领取15朵鲜花，贵族/会员额外再多领10朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: null,
        &quot;tasFinishkRate&quot;: null,
        &quot;awardCount&quot;: null,
        &quot;awardFinishCount&quot;: null
      },
      {
        &quot;taskID&quot;: 20008,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;观看直播&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 10,
        &quot;vipAwardFlower&quot;: 20,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;观看直播10分钟，可领取10朵鲜花，贵族/会员额外再多领10朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: null,
        &quot;tasFinishkRate&quot;: null,
        &quot;awardCount&quot;: null,
        &quot;awardFinishCount&quot;: null
      },
      {
        &quot;taskID&quot;: 20009,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;每日充值&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 10,
        &quot;vipAwardFlower&quot;: 20,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;充值任意金额，可领取10朵鲜花，贵族/会员额外再多领10朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: null,
        &quot;tasFinishkRate&quot;: null,
        &quot;awardCount&quot;: null,
        &quot;awardFinishCount&quot;: null
      },
      {
        &quot;taskID&quot;: 20005,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;发布作品&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 10,
        &quot;vipAwardFlower&quot;: 15,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;公开发布一首作品，可领取10朵鲜花，贵族/会员额外再多领5朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: 2,
        &quot;tasFinishkRate&quot;: 1,
        &quot;awardCount&quot;: 0,
        &quot;awardFinishCount&quot;: 1
      },
      {
        &quot;taskID&quot;: 20001,
        &quot;taskType&quot;: 2,
        &quot;taskName&quot;: &quot;分享作品&quot;,
        &quot;taskMode&quot;: 0,
        &quot;taskLimit&quot;: 1,
        &quot;taskCount&quot;: 1,
        &quot;awardMode&quot;: null,
        &quot;awardFlower&quot;: 3,
        &quot;vipAwardFlower&quot;: 6,
        &quot;property&quot;: null,
        &quot;remark&quot;: &quot;分享作品到站外，可领取3朵鲜花，贵族/会员额外再多领3朵&quot;,
        &quot;activityStartTime&quot;: null,
        &quot;activityEndTime&quot;: null,
        &quot;activityID&quot;: null,
        &quot;taskState&quot;: 2,
        &quot;tasFinishkRate&quot;: 1,
        &quot;awardCount&quot;: 0,
        &quot;awardFinishCount&quot;: 1
      }
    ],
     &quot;dayActiveRecords&quot;: [
         {
             &quot;taskID&quot;: 30012,
             &quot;taskType&quot;: 3,
             &quot;taskName&quot;: &quot;每日赠送礼物领26朵鲜花&quot;,
             &quot;taskMode&quot;: 1,
             &quot;taskLimit&quot;: 1,
             &quot;taskCount&quot;: 1,
             &quot;awardMode&quot;: 0,
             &quot;awardFlower&quot;: 26,
             &quot;vipAwardFlower&quot;: 52,
             &quot;property&quot;: 1,
             &quot;remark&quot;: &quot;只要送出乐币礼物，即可领取26朵鲜花，会员额外领取26朵&quot;,
             &quot;activityStartTime&quot;: null,
             &quot;activityEndTime&quot;: null,
             &quot;activityID&quot;: null,
             &quot;taskState&quot;: 0,
             &quot;tasFinishkRate&quot;: 20010,
             &quot;awardCount&quot;: 0,
             &quot;awardFinishCount&quot;: 1,
             &quot;activityLink&quot;: null
         },
         {
             &quot;taskID&quot;: 30013,
             &quot;taskType&quot;: 3,
             &quot;taskName&quot;: &quot;每日赠送100乐币礼物领60朵鲜花&quot;,
             &quot;taskMode&quot;: 1,
             &quot;taskLimit&quot;: 1,
             &quot;taskCount&quot;: 1,
             &quot;awardMode&quot;: 0,
             &quot;awardFlower&quot;: 60,
             &quot;vipAwardFlower&quot;: 0,
             &quot;property&quot;: 2,
             &quot;remark&quot;: &quot;只要送出100乐币礼物，即可获得60朵鲜花奖励&quot;,
             &quot;activityStartTime&quot;: null,
             &quot;activityEndTime&quot;: null,
             &quot;activityID&quot;: null,
             &quot;taskState&quot;: 0,
             &quot;tasFinishkRate&quot;: 20011,
             &quot;awardCount&quot;: 1,
             &quot;awardFinishCount&quot;: 0,
             &quot;activityLink&quot;: null
         },
         {
             &quot;taskID&quot;: 30014,
             &quot;taskType&quot;: 3,
             &quot;taskName&quot;: &quot;每日赠送1000乐币礼物领200朵鲜花&quot;,
             &quot;taskMode&quot;: 1,
             &quot;taskLimit&quot;: 1,
             &quot;taskCount&quot;: 1,
             &quot;awardMode&quot;: 0,
             &quot;awardFlower&quot;: 200,
             &quot;vipAwardFlower&quot;: 0,
             &quot;property&quot;: 3,
             &quot;remark&quot;: &quot;只要送出1000乐币礼物，即可获得200朵鲜花奖励&quot;,
             &quot;activityStartTime&quot;: null,
             &quot;activityEndTime&quot;: null,
             &quot;activityID&quot;: null,
             &quot;taskState&quot;: 0,
             &quot;tasFinishkRate&quot;: 20010,
             &quot;awardCount&quot;: 1,
             &quot;awardFinishCount&quot;: 0,
             &quot;activityLink&quot;: null
         }
     ], 
     &quot;authRecords&quot;: [{
		&quot;activityLink&quot;: &quot;https://www.baidu.com&quot;,//活动跳转地址
		&quot;awardFlower&quot;: 0,
		&quot;awardMode&quot;: 0,
		&quot;iconImg&quot;: &quot;&quot;,	//活动左上角图片
		&quot;property&quot;: 0.0,
		&quot;remark&quot;: &quot;红人周任务。。。。。&quot;,	//活动描述
		&quot;taskCount&quot;: 1,
		&quot;taskID&quot;: 40001,
		&quot;taskImg&quot;: &quot;&quot;,//活动图片
		&quot;taskLimit&quot;: 1,
		&quot;taskMode&quot;: 0,
		&quot;taskName&quot;: &quot;红人周任务&quot;,//活动名称
		&quot;taskState&quot;: 1,
		&quot;taskType&quot;: 5,
		&quot;vipAwardFlower&quot;: 0
	}]
     

  }
}
</code></pre>
<h5>任务对象模型 myTaskInfo</h5>
<pre><code>private Long taskID;         //任务编号
private int taskType;        //&#39;任务类型.1:签到任务,2:每日任务,3:活动任务&#39;,
private String taskName;         //任务名称
private int taskMode;           //任务模式.0:单次任务,1:多次任务
private int taskLimit;           //单次任务完成标准阈值
private int taskCount;           //任务可完成次数
private int awardMode;           //奖励领取模式.0:每次领取,1:全部完成后领取&#39;,
private int awardFlower;        //任务完成奖励的鲜花数
private int vipAwardFlower;           //VIP任务完成奖励的鲜花数
private String remark;           //任务描述
private int taskState;           //任务状态 null:未参与；0表示未领取,1表示已部分领取,2表示已全部领取;-1表示参与中
private int tasFinishkRate;           //任务完成进度
private int awardCount;           //可领取奖励次数
private int awardFinishCount;           //已领取奖励次数
...
</code></pre>
<h3>1.23、根据不同的任务增加花朵</h3>
<h5>接口链接</h5>
<p>   URL地址：<a href='https://music.51vv.com/sodnew/user/task/addFlowers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/addFlowers.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>900004830</td><td>用户id</td></tr><tr><td>任务id</td><td>taskID</td><td>是</td><td>Long</td><td>20001</td><td>任务id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>   {
     &quot;retCode&quot;: &quot;1000&quot;,
     &quot;retMsg&quot;: &quot;success&quot;
   }
</code></pre>
<h3>1.24、保存支付信息</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/user/savePayInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/savePayInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>900004830</td><td>用户id</td></tr><tr><td>订单号</td><td>payOrderId</td><td>是</td><td>String</td><td>20001</td><td>订单号</td></tr><tr><td>支付公司标识</td><td>payVendor</td><td>是</td><td>Integer</td><td>20001</td><td>支付公司标识[60-苹果支付]</td></tr><tr><td>商品支付信息</td><td>payInfo</td><td>是</td><td>String</td><td>20001</td><td>商品支付信息</td></tr><tr><td>商品ID</td><td>payItemId</td><td>是</td><td>String</td><td>20001</td><td>商品ID</td></tr><tr><td>票单凭据</td><td>receipt</td><td>是</td><td>String</td><td>20001</td><td>票单凭据</td></tr><tr><td>交易标示符</td><td>transactionIdentifier</td><td>是</td><td>String</td><td>20001</td><td>交易标示符</td></tr><tr><td>支付失败错误码</td><td>transactionErrorcode</td><td>是</td><td>String</td><td>20001</td><td>支付失败错误码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
  &quot;retCode&quot;: &quot;1000&quot;,
  &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>1.25、查询星访谈信息</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/recommend/queryTopStarInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/recommend/queryTopStarInfo.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
  &quot;retCode&quot;: &quot;1000&quot;,
  &quot;retMsg&quot;: &quot;success&quot;,
  &quot;starList&quot;: [
    {
      &quot;ID&quot;: 4,
      &quot;createTime&quot;: 1530257303000,
      &quot;linkUrl&quot;: &quot;www.51vv.com&quot;,
      &quot;name&quot;: &quot;你一定会在这里&quot;,
      &quot;nickName&quot;: &quot;Neil&quot;,
      &quot;photoUrl&quot;: &quot;www.51vv.com&quot;,
      &quot;state&quot;: 1,
      &quot;updateTime&quot;: 1530325489000,
      &quot;userID&quot;: 900004830
    },
    {
      &quot;ID&quot;: 3,
      &quot;createTime&quot;: 1530257258000,
      &quot;linkUrl&quot;: &quot;www.51vv.com&quot;,
      &quot;name&quot;: &quot;今天你吃鸡了吗&quot;,
      &quot;nickName&quot;: &quot;测试测试&quot;,
      &quot;photoUrl&quot;: &quot;www.51vv.com&quot;,
      &quot;state&quot;: 1,
      &quot;updateTime&quot;: 1530325645000,
      &quot;userID&quot;: 900003378
    },
    {
      &quot;ID&quot;: 2,
      &quot;createTime&quot;: 1530257222000,
      &quot;linkUrl&quot;: &quot;www.51vv.com&quot;,
      &quot;name&quot;: &quot;哈哈哈，被我打败啦&quot;,
      &quot;nickName&quot;: &quot;测试_假代码_down&quot;,
      &quot;photoUrl&quot;: &quot;www.51vv.com&quot;,
      &quot;state&quot;: 1,
      &quot;updateTime&quot;: 1530325677000,
      &quot;userID&quot;: 900002698
    }
  ]
}
</code></pre>
<h5>星访谈对象模型 starList</h5>
<pre><code>private Long ID;
private Long userID;//用户ID
private String name;//名称
private String photoUrl;//照片路径
private String linkUrl;//跳转链接
private String nickName;//昵称
private Short state;
private Date createTime;
private Date updateTime;
...
</code></pre>
<h3>1.26、最近入驻</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/recommend/queryRecentlyEnteredInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/recommend/queryRecentlyEnteredInfo.htm</a></p>
<h4>请求参数</h4>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
  &quot;retCode&quot;: &quot;1000&quot;,
  &quot;authUserList&quot;: [
    {
      &quot;authInfo&quot;: &quot;&quot;,
      &quot;authType&quot;: 2,
      &quot;concernState&quot;: 0,
      &quot;memberExpiretime&quot;: 1451577600000,
      &quot;nickname&quot;: &quot;金友们新年快乐\uD83C\uDF86&quot;,
      &quot;photo1&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/09/21/170921164324d5ab4b300ef84c84.jpg&quot;,
      &quot;photo2&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/09/21/170921164324d5ab4b300ef84c84_300.jpg&quot;,
      &quot;photo3&quot;: &quot;&quot;,
      &quot;userID&quot;: &quot;900004484&quot;
    }
  ],
  &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h5>最近入驻对象模型 authUserList</h5>
<pre><code>private String userID;
private String nickname;//昵称
private String photo1;// 头像
private String photo2;
private String photo3;
private int authType;// 认证类型
private String authInfo;//认证信息
private long memberExpiretime;
private List vip;// 201:会员
private int concernState; //0： 未关注  1：已关注 2：好友
...
</code></pre>
<h3>1.27、家族拉新列表</h3>
<h5>接口作者：陈越</h5>
<h5>是否鉴权：是</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/stat/familyInviteList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/stat/familyInviteList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族Id</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回信息</td><td>limitTime</td><td>是</td><td>Long</td><td>10000</td><td>限制时间的时间戳</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;:&quot;1000&quot;,
    &quot;retMsg&quot;:&quot;success&quot;,
    &quot;limitTime&quot;:100000,
    &quot;result&quot;:{
        &quot;list&quot;:[
            {
                &quot;dateTime&quot;:&quot;2020年11月12日&quot;,
                &quot;memberList&quot;:[
                    {
                        &quot;userId&quot;:900009929,
                        &quot;userPhoto&quot;:&quot;&quot;
                    }
                ]
            },
            {
                &quot;dateTime&quot;:&quot;2020年11月11日&quot;,
                &quot;memberList&quot;:[
                    {
                        &quot;userId&quot;:900009928,
                        &quot;userPhoto&quot;:&quot;&quot;
                    }
                ]
            }
        ]
    }
}
</code></pre>
<h3>2.1、查询是否是会员</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/user/isVip.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/isVip.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>否</td><td>Long</td><td>10000</td><td>用户Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>会员信息</td><td>vipInfo</td><td>&nbsp;</td><td>&nbsp;</td><td>没充过会员返回空，否则返回会员信息</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;vipInfo&quot; : {
        &quot;state&quot;: 1,
        &quot;startTIme&quot;: 1478263201,
        &quot;expireTime&quot;: 1478277532
    }
}
</code></pre>
<pre><code>private Short state;            // 服务状态.1表示有效.0表示失效
private Long startTIme;         // 开始时间(会员未中断，按最早充值时间算，如果会员中断后再续，按续费时间算)
private Long expireTime;        // 过期时间
</code></pre>
<h3>2.2、查询用户剩余乐币和鲜花</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/user/myGoldAndFlower.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/myGoldAndFlower.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>否</td><td>Long</td><td>10000</td><td>用户Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>创建时间</td><td>memberList</td><td>是</td><td>JSONObject</td><td>&nbsp;</td><td>剩余乐币和鲜花</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;diamondAndFlower&quot;: {
        &quot;diamondCount&quot;: 200, 
        &quot;flowerCount&quot;: 10
    }, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>2.3、查询用户今日消费乐币</h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/user/todayConsumption.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/todayConsumption.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>否</td><td>Long</td><td>10000</td><td>用户Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>乐币数</td><td>diamond</td><td>是</td><td>Long</td><td>&nbsp;</td><td>可兑换的乐币数</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;retCode&quot;: &quot;1000&quot;, 
    &quot;diamond&quot;: 158, 
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>2.4、查询登录用户信息        </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/user/getLoginUser.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/getLoginUser.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,0表示提交成功,返回13008表示用户没有登录</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;result&quot;: &quot;0&quot;, 
    &quot;resMsg&quot;: &quot;success&quot;, 
    &quot;userInfo&quot;: &quot;{\&quot;nickName\&quot;:\&quot;丁伟\&quot;,\&quot;userId\&quot;:\&quot;1143434\&quot;,\&quot;userImg\&quot;:\&quot;http://www.g.cn/img/1123\&quot;}&quot;, 
    &quot;openId&quot;: &quot;o2RvowBf7sOVJf8kJksUEMceaDqo&quot;
}
</code></pre>
<h3>2.5、获取用户微信公众号openId        </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：	<a href='https://music.51vv.com/sodnew/trans/user/getOpenId.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/getOpenId.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>跳转URL</td><td>redirectUrl</td><td>是</td><td>String</td><td>&nbsp;</td><td>通过该接口获得微信openId后跳转地址</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<p>通过微信获得当前用户的openId后，页面自动跳转至redirectUrl，用户的微信openId信息保存到服务端</p>
<h3>2.6、切换充值用户        </h3>
<h5>接口作者：丁志伟，张恕征</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/user/changeUser.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/user/changeUser.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>是</td><td>Long</td><td>10000</td><td>用户Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,0表示提交成功,返回13008表示用户没有登录</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;result&quot;: &quot;0&quot;, 
    &quot;resMsg&quot;: &quot;success&quot;, 
    &quot;userInfo&quot;: &quot;{\&quot;nickName\&quot;:\&quot;丁伟\&quot;,\&quot;userId\&quot;:\&quot;1143434\&quot;,\&quot;userImg\&quot;:\&quot;http://www.g.cn/img/1123\&quot;}&quot;
}
</code></pre>
<h2>3、礼物相关API列表</h2>
<h3>3.1、查询礼物</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/common/list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/common/list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>&nbsp;</td><td>错误提示信息</td></tr><tr><td>礼物信息</td><td>gifts</td><td>否</td><td>List<Gift></td><td>&nbsp;</td><td>礼物信息</td></tr></tbody>
</table></figure>
<h5>礼物模型 Gift</h5>
<pre><code>private Long giftID;             //礼物Id
private String giftName;         //礼物名称
private Integer giftType;         //礼物类型 1鲜花 2普通礼物
private Integer level;           //礼物级别
private Long diamond;            //乐币
private BigDecimal money;        //人民币
private Integer hot;             //热度
private Integer duration;       //持续时间（小时）
private Long ticket;             //音符
private String smallImage;       //礼物小图_IOS
private String smallImageMd5;    //礼物小图md5_IOS
private String largeImage;       //礼物大图_IOS
private String largeImageMd5;    //礼物大图md5_IOS
private String viewImage;        //礼物预览图_IOS
private String viewImageMd5;     //礼物预览图md5_IOS
private Long createTime;
private Long updateTime;
private String smallImage_android;       //礼物小图_Android
private String smallImageMd5_android;    //礼物小图md5_Android
private String largeImage_android;       //礼物大图_Android
private String largeImageMd5_android;    //礼物大图md5_Android
private String viewImage_android;        //礼物预览图_Android
private String viewImageMd5_android;     //礼物预览图md5_Android
private String giftPacket;               //礼物资源URL
private String giftPacketMd5;            //礼物资源MD5
private Integer IsEngine;                //是否使用礼物引擎
private String giftEffect;               //礼物特效

private Integer displayGiftType;       //礼物显示类型
private String extendGiftPacket;       //新礼物资源
private String extendGiftPacketMd5;    //新礼物资源MD5
private String giftIcon;               //新礼物缩略图
private String extendGiftEffect;       //扩展礼物效果
private String unitName;               //礼物量词.比如 一辆车,一朵花的辆和朵

private Integer isXuan;                //是否显示右上角图标
private String giftXuan;               //礼物右上角图标资源URL
private String giftXuanMd5;            //礼物右上角图标资源MD5
private String giftXuan_android;       //礼物右上角图标资源URL(安卓)
private String giftXuanMd5_android;    //礼物右上角图标资源MD5(安卓)

private String extendGiftPacket2;      //回放页礼物资源
private String extendGiftPacket2Md5;   //回放页礼物资源MD5
private String extendGiftEffect2;      //回放页礼物效果
...
</code></pre>
<h3>3.2、送礼物</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/common/sendGift.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/common/sendGift.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>送礼人ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>送礼人ID</td></tr><tr><td>收礼人ID</td><td>toUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>收礼人ID</td></tr><tr><td>礼物ID</td><td>giftID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>礼物ID</td></tr><tr><td>礼物数量</td><td>giftCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>礼物数量</td></tr><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表 1000成功,1001参数错误,14001礼物失效 1005失败,1096作品不存在或删除,1097余额不足（retCode<mark>1000 &amp;&amp; result</mark>1表示送礼成功）</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>送礼结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>送礼结果，-1权限问题失败、0失败、1成功（retCode<mark>1000 &amp;&amp; result</mark>1表示送礼成功）</td></tr><tr><td>送礼人乐币余额</td><td>sender_diamond</td><td>否</td><td>long</td><td>&nbsp;</td><td>送礼人乐币余额</td></tr></tbody>
</table></figure>
<h3>3.3、查询作品贡献榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/zp/contribute_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/zp/contribute_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>&nbsp;</td><td>错误提示信息</td></tr><tr><td>鲜花数</td><td>totalFlowerNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>鲜花总数</td></tr><tr><td>乐币数</td><td>totalDiamondNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>乐币总数</td></tr><tr><td>礼物贡献</td><td>giftContributes</td><td>否</td><td>List<GiftContribute></td><td>&nbsp;</td><td>礼物贡献</td></tr><tr><td>我的贡献</td><td>myContribute</td><td>否</td><td>GiftContribute</td><td>&nbsp;</td><td>我的贡献</td></tr></tbody>
</table></figure>
<h5>礼物贡献模型 GiftContribute</h5>
<pre><code>private Long userID;             //用户Id
private string nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private Long consumedDiamond;    //消费的乐币
private Long flowerNum;          //送出的鲜花数
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星
private Integer vip;             //是否vip 1是 0否
private Integer flowerAmount;    //鲜花数量
private Integer anonyousGivegiftIcon;    //显示私密图标 1)显示 其他)不显示
...
</code></pre>
<h3>3.4、查询用户礼物贡献榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/contribute_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/contribute_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>礼物贡献</td><td>giftContributes</td><td>否</td><td>List</td><td>&nbsp;</td><td>礼物贡献</td></tr><tr><td>总音符数</td><td>totalMoney</td><td>否</td><td>Long</td><td>&nbsp;</td><td>总音符数</td></tr></tbody>
</table></figure>
<h5>礼物贡献模型 GiftContribute</h5>
<pre><code>private Long userID;             //用户Id
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private Long consumedDiamond;    //消费的乐币
private Long flowerNum;          //送出的鲜花数
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星
private Integer vip;             //是否vip 1是 0否
private Integer flowerAmount;    //鲜花数量
private Integer anonyousGivegiftIcon;    //显示私密图标 1)显示 其他)不显示
</code></pre>
<h3>3.5、近期收到礼物</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/recent_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/recent_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>礼物数</td><td>totalGiftNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>礼物总数</td></tr><tr><td>近期贡献</td><td>recentGifts</td><td>否</td><td>List<RecentGift></td><td>&nbsp;</td><td>近期贡献</td></tr><tr><td>历史贡献</td><td>giftContributeByGifts</td><td>否</td><td>List<GiftContributeByGift></td><td>&nbsp;</td><td>历史贡献</td></tr></tbody>
</table></figure>
<h5>礼物贡献简要模型 RecentGift</h5>
<pre><code>private Long giftID;             //礼物ID
private string giftName;         //礼物名称
private Integer amount;          //礼物数量
private String unitName;         //数量单位
</code></pre>
<h5>礼物贡献模型 GiftContributeByGift</h5>
<pre><code>private Long giftID;             //礼物ID
private String giftName;         //礼物名称
private Long diamond;            //礼物单价
private Integer amount;          //礼物数量
private String unitName;         //数量单位
private String smallImage;       //礼物小图_IOS
private String smallImageMd5;    //礼物小图md5_IOS
private String largeImage;       //礼物大图_IOS
private String largeImageMd5;    //礼物大图md5_IOS
private String viewImage;        //礼物预览图_IOS
private String viewImageMd5;     //礼物预览图md5_IOS
private String smallImage_android;       //礼物小图_Android
private String smallImageMd5_android;    //礼物小图md5_Android
private String largeImage_android;       //礼物大图_Android
private String largeImageMd5_android;    //礼物大图md5_Android
private String viewImage_android;        //礼物预览图_Android
private String viewImageMd5_android;     //礼物预览图md5_Android
...
</code></pre>
<h3>3.6、礼物消息查询</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/msg_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/msg_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>礼物消息</td><td>giftMessages</td><td>否</td><td>List<GiftMessage></td><td>&nbsp;</td><td>礼物消息</td></tr></tbody>
</table></figure>
<h5>礼物消息 GiftMessage</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer sex;            //用户性别 1男 2女
private Integer authType;
private Integer moneyLevel;      //用户财富等级
private Integer vip;
private Long AVID;               //作品ID
private String zpName;           //作品名称
private Short zpStatus;          //作品状态
private Short exFileType;        //作品扩展类型 0独唱 1合唱 2发起合唱
private Long giftID;             //礼物ID
private String giftName;         //礼物名称
private String unitName;         //礼物量词
private Integer amount;          //礼物数量
private Integer giftType;        //礼物类型 1鲜花礼物 2普通礼物
private String sendTimeStr;     //格式化后的发送消息时间
private String smallImage;       //礼物小图_IOS
private String smallImageMd5;    //礼物小图md5_IOS
private String largeImage;       //礼物大图_IOS
private String largeImageMd5;    //礼物大图md5_IOS
private String viewImage;        //礼物预览图_IOS
private String viewImageMd5;     //礼物预览图md5_IOS
private String smallImage_android;       //礼物小图_Android
private String smallImageMd5_android;    //礼物小图md5_Android
private String largeImage_android;       //礼物大图_Android
private String largeImageMd5_android;    //礼物大图md5_Android
private String viewImage_android;        //礼物预览图_Android
private String viewImageMd5_android;     //礼物预览图md5_Android
private Integer fromType; // 来源类型 0作品 15文章(如果是文章时，AVID代表文章id，zpName代表文章标题，zpStatus代表文章状态)
...
</code></pre>
<h3>3.7、查询作品用户贡献详情</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/zp/contribute_detail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/zp/contribute_detail.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>礼物贡献(按礼物)</td><td>giftContributeByGifts</td><td>否</td><td>List<GiftContributeByGift></td><td>&nbsp;</td><td>礼物贡献(按礼物)</td></tr></tbody>
</table></figure>
<h5>近期礼物贡献模型 GiftContributeByGift</h5>
<pre><code>private Long giftID;             //礼物ID
private String giftName;         //礼物名称
private Long diamond;            //礼物单价
private Integer amount;          //礼物数量
private String unitName;         //数量单位
private String smallImage;       //礼物小图_IOS
private String smallImageMd5;    //礼物小图md5_IOS
private String largeImage;       //礼物大图_IOS
private String largeImageMd5;    //礼物大图md5_IOS
private String viewImage;        //礼物预览图_IOS
private String viewImageMd5;     //礼物预览图md5_IOS
private String smallImage_android;       //礼物小图_Android
private String smallImageMd5_android;    //礼物小图md5_Android
private String largeImage_android;       //礼物大图_Android
private String largeImageMd5_android;    //礼物大图md5_Android
private String viewImage_android;        //礼物预览图_Android
private String viewImageMd5_android;     //礼物预览图md5_Android
...
</code></pre>
<h3>3.8、查询作品贡献摘要</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/zp/contribute_intro.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/zp/contribute_intro.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>鲜花总数</td><td>totalFlowerNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>鲜花总数</td></tr><tr><td>乐币总数</td><td>totalDiamondNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>乐币总数</td></tr><tr><td>鲜花礼物摘要</td><td>flowerContributeIntros</td><td>否</td><td>List<GiftContributeIntro></td><td>&nbsp;</td><td>鲜花礼物摘要</td></tr><tr><td>礼物摘要</td><td>giftContributeIntros</td><td>否</td><td>List<GiftContributeIntro></td><td>&nbsp;</td><td>礼物摘要</td></tr></tbody>
</table></figure>
<h5>贡献简要模型 GiftContributeIntro</h5>
<pre><code>private Long userID;             //用户ID
private String photo;            //用户头像
private Integer num;             //赠送礼物或者鲜花数量
private Integer rank;            //排名
private Integer moneyLevel;      //财富等级
private Integer anonyousGivegiftIcon;    //显示私密图标 1)显示 其他)不显示
...
</code></pre>
<h3>3.9、查询用户贡献摘要</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/contribute_intro.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/contribute_intro.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>鲜花总数</td><td>totalFlowerNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>鲜花总数</td></tr><tr><td>乐币总数</td><td>totalDiamondNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>乐币总数</td></tr><tr><td>鲜花礼物摘要</td><td>flowerContributeIntros</td><td>否</td><td>List<GiftContributeIntro></td><td>&nbsp;</td><td>鲜花礼物摘要</td></tr><tr><td>礼物摘要</td><td>giftContributeIntros</td><td>否</td><td>List<GiftContributeIntro></td><td>&nbsp;</td><td>礼物摘要</td></tr></tbody>
</table></figure>
<h5>贡献简要模型 GiftContributeIntro</h5>
<pre><code>private Long userID;             //用户ID
private String photo;            //用户头像
private Integer num;             //赠送礼物或者鲜花数量
private Integer rank;            //排名
private Integer moneyLevel;      //财富等级
...
</code></pre>
<h3>3.10、房间内赠送礼物</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/common/sendGiftInRoom.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/common/sendGiftInRoom.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>送礼人ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>送礼人ID</td></tr><tr><td>收礼人ID</td><td>toUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>收礼人ID</td></tr><tr><td>礼物ID</td><td>giftID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>礼物ID</td></tr><tr><td>礼物数量</td><td>giftCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>礼物数量</td></tr><tr><td>房间ID</td><td>roomID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>房间ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>送礼结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>送礼结果，0失败、1成功</td></tr></tbody>
</table></figure>
<h3>3.11、查询作品送礼日志</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/zp/gift_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/zp/gift_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>送礼日志</td><td>giftMessages</td><td>否</td><td>List<GiftMessage></td><td>&nbsp;</td><td>送礼日志</td></tr></tbody>
</table></figure>
<h5>礼物消息 GiftMessage</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer sex;            //用户性别 1男 2女
private Integer authType;
private Integer moneyLevel;      //用户财富等级
private Integer vip;
private Long AVID;               //作品ID
private String zpName;           //作品名称
private Short zpStatus;          //作品状态
private Long giftID;             //礼物ID
private String giftName;         //礼物名称
private String unitName;         //礼物量词
private Integer amount;          //礼物数量
private Integer giftType;        //礼物类型 1鲜花礼物 2普通礼物
private String sendTimeStr;     //格式化后的发送消息时间
private String smallImage;       //礼物小图_IOS
private String smallImageMd5;    //礼物小图md5_IOS
private String largeImage;       //礼物大图_IOS
private String largeImageMd5;    //礼物大图md5_IOS
private String viewImage;        //礼物预览图_IOS
private String viewImageMd5;     //礼物预览图md5_IOS
private String smallImage_android;       //礼物小图_Android
private String smallImageMd5_android;    //礼物小图md5_Android
private String largeImage_android;       //礼物大图_Android
private String largeImageMd5_android;    //礼物大图md5_Android
private String viewImage_android;        //礼物预览图_Android
private String viewImageMd5_android;     //礼物预览图md5_Android
private Integer anonyousGivegiftIcon;    //显示私密图标 1)显示 其他)不显示
...
</code></pre>
<h3>3.12、查询用户鲜花贡献榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/flower_contribute_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/flower_contribute_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>礼物贡献</td><td>giftContributes</td><td>否</td><td>List</td><td>&nbsp;</td><td>礼物贡献</td></tr><tr><td>总鲜花数</td><td>totalFlowers</td><td>否</td><td>Long</td><td>&nbsp;</td><td>总鲜花数</td></tr></tbody>
</table></figure>
<h5>礼物贡献模型 GiftContribute</h5>
<pre><code>private Long userID;             //用户Id
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private Long consumedDiamond;    //消费的乐币
private Long flowerNum;          //送出的鲜花数
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星
private Integer vip;             //是否vip 1是 0否
private Integer flowerAmount;    //鲜花数量
...
</code></pre>
<h3>3.13、查询作品鲜花榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/zp/contribute_flower_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/zp/contribute_flower_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>&nbsp;</td><td>错误提示信息</td></tr><tr><td>鲜花数</td><td>totalFlowerNum</td><td>否</td><td>long</td><td>&nbsp;</td><td>鲜花总数</td></tr><tr><td>礼物贡献</td><td>giftContributes</td><td>否</td><td>List<GiftContribute></td><td>&nbsp;</td><td>礼物贡献</td></tr></tbody>
</table></figure>
<h5>礼物贡献模型 GiftContribute</h5>
<pre><code>private Long userID;             //用户Id
private string nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private Long consumedDiamond;    //消费的乐币
private Long flowerNum;          //送出的鲜花数
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星
private Integer vip;             //是否vip 1是 0否
private Integer flowerAmount;    //鲜花数量
private Integer anonyousGivegiftIcon;    //显示私密图标 1)显示 其他)不显示
...
</code></pre>
<h3>3.14、查询用户榜一</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/contribute_first.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/contribute_first.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>礼物贡献</td><td>giftContribute</td><td>否</td><td>GiftContribute</td><td>&nbsp;</td><td>礼物贡献，如果礼物榜没有数据，就用鲜花榜；鲜花榜没有数据，返回null</td></tr></tbody>
</table></figure>
<h5>礼物贡献模型 GiftContribute</h5>
<pre><code>private Long userID;             //用户Id
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private Long consumedDiamond;    //消费的乐币
private Long flowerNum;          //送出的鲜花数
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星
private Integer vip;             //是否vip 1是 0否
private Integer flowerAmount;    //鲜花数量
</code></pre>
<h3>3.15、整合礼物消息查询</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/gift/user/msg_list_integrate.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/gift/user/msg_list_integrate.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>行数</td><td>rows</td><td>否</td><td>Integer</td><td>100</td><td>行数</td></tr><tr><td>日志Id</td><td>lastLogId</td><td>否</td><td>String</td><td>&nbsp;</td><td>上一次列表最后一个日志Id，第一次传空</td></tr><tr><td>日志时间</td><td>lastCreateTime</td><td>否</td><td>Long</td><td>&nbsp;</td><td>上一次列表最后一个日志时间, 第一次传空</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>礼物消息</td><td>giftMessages</td><td>否</td><td>List<GiftMessage></td><td>&nbsp;</td><td>礼物消息</td></tr></tbody>
</table></figure>
<h5>礼物消息 GiftMessage</h5>
<pre><code>private String logId;            //日志Id（新增）
private Long createTime;         //创建时间（新增）

private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer sex;            //用户性别 1男 2女
private Integer authType;
private Integer moneyLevel;      //用户财富等级
private Integer vip;
private Long AVID;               //作品ID
private String zpName;           //作品名称
private Short zpStatus;          //作品状态
private Short exFileType;        //作品扩展类型 0独唱 1合唱 2发起合唱
private Long giftID;             //礼物ID
private String giftName;         //礼物名称
private String unitName;         //礼物量词
private Integer amount;          //礼物数量
private Integer giftType;        //礼物类型 1鲜花礼物 2普通礼物
private String sendTimeStr;     //格式化后的发送消息时间
private String smallImage;       //礼物小图_IOS
private String smallImageMd5;    //礼物小图md5_IOS
private String largeImage;       //礼物大图_IOS
private String largeImageMd5;    //礼物大图md5_IOS
private String viewImage;        //礼物预览图_IOS
private String viewImageMd5;     //礼物预览图md5_IOS
private String smallImage_android;       //礼物小图_Android
private String smallImageMd5_android;    //礼物小图md5_Android
private String largeImage_android;       //礼物大图_Android
private String largeImageMd5_android;    //礼物大图md5_Android
private String viewImage_android;        //礼物预览图_Android
private String viewImageMd5_android;     //礼物预览图md5_Android
private Integer fromType; // 来源类型 0作品 15文章(如果是文章时，AVID代表文章id，zpName代表文章标题，zpStatus代表文章状态)
...
</code></pre>
<h2>4、等级相关API接口</h2>
<h3>4.1、用户等级</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/user/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/user/query.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户等级</td><td>userLevel</td><td>否</td><td>UserLevel</td><td>&nbsp;</td><td>用户等级</td></tr></tbody>
</table></figure>
<h5>用户等级模型 UserLevel</h5>
<pre><code>private Long userID;                  //用户ID
private Integer friendRank;           //好友排行
private Integer rank;                 //全国排行
private Integer userLevel;            //用户等级
private Integer exp;                  //用户经验
private Integer currentLevelExp;      //当前等级经验
private Integer prevLevel;            //上一等级
private Integer prevLevelExp;         //上一等级级经验
private String  levelName;            //等级称谓
private String  imgUrl;               //等级图片
...
</code></pre>
<h3>4.2、用户等级总榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/user/billboard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/user/billboard.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户等级排行</td><td>userLevelRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户等级排行</td></tr></tbody>
</table></figure>
<h5>用户等级排行模型 UserLevelRank</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer userLevel;       //用户等级
private String imgUrl;     //用户等级图片
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星 2音乐人
private Integer vip;             //是否会员 1是 2不是
...
</code></pre>
<h3>4.3、用户等级好友榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/user/friend.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/user/friend.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户等级排行</td><td>userLevelRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户等级排行</td></tr></tbody>
</table></figure>
<h5>用户等级排行模型 UserLevelRank</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer userLevel;       //用户等级
private String imgUrl;     //用户等级图片
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星 2音乐人
private Integer vip;             //是否会员 1是 2不是
...
</code></pre>
<h3>4.4、歌手等级</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/singer/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/singer/query.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>歌手等级</td><td>singerLevel</td><td>否</td><td>SingerLevel</td><td>&nbsp;</td><td>歌手等级</td></tr></tbody>
</table></figure>
<h5>歌手等级模型 SingerLevel</h5>
<pre><code>private Long userID;                  //用户ID
private Integer friendRank;           //好友排行
private Integer rank;                 //全国排行
private Integer singerLevel;          //歌手等级
private Integer singerExp;            //魅力值
private Integer currentLevelExp;      //当前等级经验
private Integer prevLevel;            //上一等级
private Integer prevLevelExp;         //上一等级级经验
private String  levelName;            //等级称谓
private String  imgUrl;               //等级图片
...
</code></pre>
<h3>4.5、歌手等级总榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/singer/billboard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/singer/billboard.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>歌手等级排行</td><td>singerLevelRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>歌手等级排行</td></tr></tbody>
</table></figure>
<h5>歌手等级排行模型 SingerLevelRank</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer singerLevel;     //歌手等级
private String imgUrl;   //歌手等级图片
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星 2音乐人
private Integer vip;             //是否会员 1是 2不是
...
</code></pre>
<h3>4.6、歌手等级好友榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/singer/friend.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/singer/friend.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>歌手等级排行</td><td>singerLevelRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>歌手等级排行</td></tr></tbody>
</table></figure>
<h5>歌手等级排行模型 SingerLevelRank</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer singerLevel;     //歌手等级
private String imgUrl;   //歌手等级图片
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星 2音乐人
private Integer vip;             //是否会员 1是 2不是
...
</code></pre>
<h3>4.7、财富等级</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/money/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/money/query.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>财富等级</td><td>wealthLevel</td><td>否</td><td>WealthLevel</td><td>&nbsp;</td><td>财富等级</td></tr></tbody>
</table></figure>
<h5>财富等级模型 WealthLevel</h5>
<pre><code>private Long userID;                  //用户ID
private Integer friendRank;           //好友排行
private Integer rank;                 //全国排行
private Integer moneyLevel;           //财富等级
private Integer moneyExp;             //财富值
private Integer currentLevelExp;      //当前等级经验
private Integer prevLevel;            //上一等级
private Integer prevLevelExp;         //上一等级级经验
private String  levelName;            //等级称谓
private String  imgUrl;               //等级图片
...
</code></pre>
<h3>4.8、财富等级总榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/money/billboard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/money/billboard.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>财富等级排行</td><td>wealthLevelRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>财富等级排行</td></tr></tbody>
</table></figure>
<h5>财富等级排行模型 WealthLevelRank</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private String imgUrl;    //财富等级图片
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星 2音乐人
private Integer vip;             //是否会员 1是 2不是
...
</code></pre>
<h3>4.9、财富等级好友榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/level/money/friend.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/level/money/friend.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>财富等级排行</td><td>wealthLevelRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>财富等级排行</td></tr></tbody>
</table></figure>
<h5>财富等级排行模型 WealthLevelRank</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Integer moneyLevel;      //财富等级
private String imgUrl;    //财富等级图片
private Integer rank;            //排名
private Integer authType;        //认证状态 -1未认证 0普通用户 1明星 2音乐人
private Integer vip;             //是否会员 1是 2不是
...
</code></pre>
<h2>5、实名认证相关API列表</h2>
<h3>5.1 查询实名认证信息</h3>
<h5>接口作者：刘宏明</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authuser/realName/info.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authuser/realName/info.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>否</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>用户昵称</td><td>nickName</td><td>否</td><td>String</td><td>vv音乐主编</td><td>用户昵称</td></tr><tr><td>用户昵称</td><td>nickName</td><td>否</td><td>String</td><td>vv音乐主编</td><td>用户昵称</td></tr><tr><td>用户头像</td><td>userImg</td><td>否</td><td>String</td><td>http://**</td><td>用户头像</td></tr><tr><td>微信昵称</td><td>wxNickName</td><td>否</td><td>String</td><td>vv音乐主编</td><td>微信昵称</td></tr><tr><td>微信头像</td><td>userWxImg</td><td>否</td><td>String</td><td>http://**</td><td>微信头像</td></tr><tr><td>实名认证状态</td><td>realNameAuthState</td><td>否</td><td>Short</td><td>0</td><td>0审核中，-1未申请，1通过，2未通过</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>5.2 提交绑定微信</h3>
<h5>接口作者：刘宏明</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authuser/bind/bindUserDrawChannel.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authuser/bind/bindUserDrawChannel.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>开放平台号</td><td>openID</td><td>是</td><td>String(64)</td><td>qwezxfqwa</td><td>第三方开放平台账号</td></tr><tr><td>微信平台关联id</td><td>unionId</td><td>否</td><td>String(64)</td><td>qwezxfqwa</td><td>微信平台关联id 一个开发账号下面不同应用返回一个，其他 平台不用传</td></tr><tr><td>认证码</td><td>authCode</td><td>是</td><td>String(64)</td><td>asdads</td><td>第三方平台认证时返回的认证码</td></tr><tr><td>类型</td><td>channel</td><td>是</td><td>int</td><td>1</td><td>提现渠道类型 1 移动端微信</td></tr><tr><td>认证码有效期</td><td>authCodeTime</td><td>否</td><td>Long</td><td>1464765594111</td><td>第三方平台认证时返回的认证码有效期</td></tr><tr><td>微信昵称</td><td>wxNickName</td><td>是</td><td>String</td><td>张飞</td><td>提现微信账户的昵称</td></tr><tr><td>微信头像</td><td>userWxImg</td><td>是</td><td>String</td><td>Http://***.png</td><td>提提现微信账户的头像</td></tr><tr><td>用户机器码</td><td>pcID</td><td>是</td><td>String</td><td>87487238732</td><td>用户机器码</td></tr><tr><td>客户端版本号</td><td>clientVersion</td><td>是</td><td>String</td><td>1.0.1</td><td>客户端版本号</td></tr><tr><td>客户端IP</td><td>clientIP</td><td>是</td><td>String</td><td>192.168.1.1</td><td>客户端IP</td></tr><tr><td>客户端操作系统版本号</td><td>clientOS</td><td>是</td><td>String</td><td>Windows 7</td><td>客户端操作系统版本号</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>5.3 提交实名认证</h3>
<h5>接口作者：刘宏明</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authuser/realName/submitRealNameApply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authuser/realName/submitRealNameApply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>真是姓名</td><td>userRealName</td><td>是</td><td>String</td><td>张飞</td><td>真是姓名</td></tr><tr><td>证件类型</td><td>papersType</td><td>是</td><td>int</td><td>1</td><td>证件类型</td></tr><tr><td>证件号</td><td>papersNumber</td><td>是</td><td>String</td><td>47**</td><td>证件号</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>6.1 查询中奖历史</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/common/draw_history.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/common/draw_history.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>活动ID</td><td>actId</td><td>是</td><td>Long</td><td>1</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>page</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>中奖记录</td><td>drawHistorys</td><td>否</td><td>List<drawHistory></td><td>&nbsp;</td><td>中奖记录</td></tr></tbody>
</table></figure>
<h5>中奖记录 drawHistory</h5>
<pre><code>private String giftName;                  //奖品名称
private String drawTime;                  //中奖时间

...
</code></pre>
<h3>6.2 派送鲜花</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/common/give_flower.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/common/give_flower.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>鲜花数</td><td>flowers</td><td>是</td><td>Long</td><td>10</td><td>赠送鲜花数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>6.3 派送乐币</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/common/give_diamond.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/common/give_diamond.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>乐币数</td><td>diamond</td><td>是</td><td>Long</td><td>100</td><td>赠送的乐币数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>6.4 派送会员</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/common/give_member.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/common/give_member.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>月份</td><td>months</td><td>是</td><td>int</td><td>1</td><td>赠送会员的月份数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>6.5 七日大作战活动-抽奖</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/sevendaybattle/draw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/sevendaybattle/draw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>活动ID</td><td>actId</td><td>是</td><td>Long</td><td>1</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否有资格 1是 0无资格 必须关联微信或者手机</td></tr><tr><td>抽奖前剩余次数</td><td>chance</td><td>否</td><td>int</td><td>&nbsp;</td><td>抽奖前剩余次数</td></tr><tr><td>是否中奖</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否中奖 1是 0否 当right=1 &amp;&amp; chance&gt;0 的时候返回</td></tr><tr><td>奖品Id</td><td>giftNameId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>奖品Id 当result=1的时候返回</td></tr><tr><td>奖品名称</td><td>giftName</td><td>否</td><td>String</td><td>&nbsp;</td><td>奖品名称 当result=1的时候返回</td></tr></tbody>
</table></figure>
<h3>6.6 七日大作战活动-查询剩余抽奖次数</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/sevendaybattle/query_chance.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/sevendaybattle/query_chance.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>剩余抽奖次数</td><td>chance</td><td>是</td><td>int</td><td>2</td><td>剩余抽奖次数</td></tr></tbody>
</table></figure>
<h3>6.7 五周年活动-抽奖</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/anniversary5th/draw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/anniversary5th/draw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>活动ID</td><td>actId</td><td>是</td><td>Long</td><td>1</td><td>活动ID</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>1</td><td>类型 1小鸡 2金鸡</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否有资格 1是 0无资格 每个设备只能一个用户抽奖</td></tr><tr><td>vvID</td><td>vvID</td><td>是</td><td>long</td><td>&nbsp;</td><td>当前设备符合资格用户ID，当right=0返回</td></tr><tr><td>抽奖前剩余次数</td><td>chance</td><td>否</td><td>int</td><td>&nbsp;</td><td>抽奖前剩余次数</td></tr><tr><td>是否中奖</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否中奖 1是 0否 当right=1 &amp;&amp; chance&gt;0 的时候返回</td></tr><tr><td>奖品Id</td><td>giftNameId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>奖品Id 当result=1的时候返回</td></tr><tr><td>奖品名称</td><td>giftName</td><td>否</td><td>String</td><td>&nbsp;</td><td>奖品名称 当result=1的时候返回</td></tr></tbody>
</table></figure>
<h3>6.8 五周年活动-查询剩余抽奖次数</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/anniversary5th/query_chance.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/anniversary5th/query_chance.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>小鸡抽奖次数</td><td>s_chance</td><td>是</td><td>int</td><td>2</td><td>小鸡抽奖次数</td></tr><tr><td>金鸡抽奖次数</td><td>g_chance</td><td>是</td><td>int</td><td>2</td><td>金鸡抽奖次数</td></tr><tr><td>今日小鸡抽奖抽奖状态</td><td>s_status</td><td>是</td><td>int</td><td>2</td><td>今日小鸡抽奖抽奖状态  0未完成 1可抽 2已抽</td></tr><tr><td>今日金鸡抽奖抽奖状态</td><td>g_status</td><td>是</td><td>int</td><td>2</td><td>今日金鸡抽奖抽奖状态  0未完成 1可抽 2已抽</td></tr></tbody>
</table></figure>
<h3>6.9 五周年活动-抓鸡</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/anniversary5th/capture.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/anniversary5th/capture.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>1</td><td>类型 1小鸡 2金鸡</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否有资格 1是 0无资格 每个设备只能一个用户抽奖</td></tr><tr><td>vvID</td><td>vvID</td><td>是</td><td>long</td><td>&nbsp;</td><td>当前设备符合资格用户ID，当right=0返回</td></tr><tr><td>结果</td><td>result</td><td>是</td><td>int</td><td>2</td><td>结果 0失败 1成功 -1未完成 -2已抽</td></tr></tbody>
</table></figure>
<h3>6.10 2017活动-青春不散场-我的</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/youth/getMyYouth.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/youth/getMyYouth.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>支持数</td><td>70s</td><td>否</td><td>int</td><td>0</td><td>支持数</td></tr><tr><td>支持数</td><td>80s</td><td>否</td><td>int</td><td>0</td><td>支持数</td></tr><tr><td>支持数</td><td>90s</td><td>否</td><td>int</td><td>0</td><td>支持数</td></tr><tr><td>支持数</td><td>00s</td><td>否</td><td>int</td><td>0</td><td>支持数</td></tr><tr><td>支持数</td><td>10s</td><td>否</td><td>int</td><td>0</td><td>支持数</td></tr><tr><td>用户青春</td><td>myYouth</td><td>否</td><td>Activity2017YouthUserResult</td><td>&nbsp;</td><td>用户青春</td></tr></tbody>
</table></figure>
<h5>用户青春模型 Activity2017YouthUserResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer workNum;            //作品数
private Integer heart;              //心动数
private Integer letter;             //情书数
</code></pre>
<h3>6.11 2017活动-青春不散场-作品列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/youth/getWorkList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/youth/getWorkList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr><tr><td>排序类型</td><td>type</td><td>否</td><td>Integer</td><td>1</td><td>排序类型 1青春值倒序 2发布时间倒序</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr></tbody>
</table></figure>
<h5>作品青春模型 Activity2017YouthWorkResult</h5>
<pre><code>private Long userID;          //用户ID
private Long AVID;            //作品ID
private String nickName;      //用户昵称
private String photo;         //用户头像
private String name;          //作品名称
private Long youth;           //青春值
private Long pubTime;         //发布时间
</code></pre>
<h3>6.12 2017活动-青春不散场-用户列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/youth/getUserLists.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/youth/getUserLists.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>用户列表</td><td>universityList</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr><tr><td>用户列表</td><td>collegeList</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr><tr><td>用户列表</td><td>classList</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr></tbody>
</table></figure>
<h5>用户青春模型 Activity2017YouthUserResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer workNum;            //作品数
private Integer heart;              //心动数
private Integer letter;             //情书数
</code></pre>
<h3>6.13 春光活动-获取用户春光信息  </h3>
<h5>接口作者：吴小龙</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/spring/getUserSpringInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/spring/getUserSpringInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1005,1027(没有明文访问权限，必须先通过密文访问)</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>70021348</td></tr><tr><td>用户昵称</td><td>nichName</td><td>是</td><td>String</td><td>&nbsp;</td><td>干净利落</td></tr><tr><td>用户头像</td><td>photo</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>玉兰数量</td><td>magnoliaCount</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>牡丹数量</td><td>peonyCount</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>月季数量</td><td>chineseRoseCount</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>海棠数量</td><td>begoniaCount</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>春天里数量</td><td>springCount</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>春天值</td><td>springScore</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果JSON示例</h4>
<p>{
    &quot;retCode&quot;: 1000,
    &quot;userSpringInfo&quot;: {
        &quot;begoniaCount&quot;: null,
        &quot;userID&quot;: 70021348,
        &quot;count&quot;: null,
        &quot;nickName&quot;: &quot;干净利落&quot;,
        &quot;springScore&quot;: 223,
        &quot;springCount&quot;: 2,
        &quot;peonyCount&quot;: null,
        &quot;magnoliaCount&quot;: 22,
        &quot;photo&quot;: null,
        &quot;chineseRoseCount&quot;: null
    }
}</p>
<h3>6.14 春光活动-获取各榜单列表  </h3>
<h5>接口作者：吴小龙</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/spring/getSpringList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/spring/getSpringList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1005,1027(没有明文访问权限，必须先通过密文访问)</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>70021348</td></tr><tr><td>用户昵称</td><td>nichName</td><td>是</td><td>String</td><td>&nbsp;</td><td>干净利落</td></tr><tr><td>用户头像</td><td>photo</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>玉兰列表</td><td>magonliaList</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>牡丹列表</td><td>peonyList</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>月季列表</td><td>chineseroseList</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>海棠列表</td><td>begoniaList</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>春天值列表</td><td>springScore</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果JSON示例</h4>
<p>{
    &quot;retCode&quot;: 1000,
    &quot;springlist&quot;: {
        &quot;chineseroseList&quot;: [],
        &quot;begoniaList&quot;: [],
        &quot;magonliaList&quot;: [
            {
                &quot;userID&quot;: 70021348,
                &quot;nickName&quot;: &quot;。干净利落健健康康骷髅来咯来咯&quot;,
                &quot;photo&quot;: &quot;<a href='http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/16/12/16/161216102613cc01623100aa45e7_300.jpg' target='_blank' class='url'>http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/16/12/16/161216102613cc01623100aa45e7_300.jpg</a>&quot;,
                &quot;count&quot;: 22
            },
            {
                &quot;userID&quot;: 998357628,
                &quot;nickName&quot;: &quot;松果&quot;,
                &quot;photo&quot;: &quot;<a href='http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/15/12/24/151224160950ad231d7c54c54192_300.jpg' target='_blank' class='url'>http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/15/12/24/151224160950ad231d7c54c54192_300.jpg</a>&quot;,
                &quot;count&quot;: 6
            },
            {
                &quot;userID&quot;: 937550848,
                &quot;nickName&quot;: &quot;v4aoy&quot;,
                &quot;photo&quot;: &quot;&quot;,
                &quot;count&quot;: 2
            }
        ],
        &quot;peonyList&quot;: [],
        &quot;totalList&quot;: [
            {
                &quot;userID&quot;: 70021348,
                &quot;nickName&quot;: &quot;。干净利落健健康康骷髅来咯来咯&quot;,
                &quot;photo&quot;: &quot;<a href='http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/16/12/16/161216102613cc01623100aa45e7_300.jpg' target='_blank' class='url'>http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/16/12/16/161216102613cc01623100aa45e7_300.jpg</a>&quot;,
                &quot;count&quot;: 223
            },
            {
                &quot;userID&quot;: 998357628,
                &quot;nickName&quot;: &quot;松果&quot;,
                &quot;photo&quot;: &quot;<a href='http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/15/12/24/151224160950ad231d7c54c54192_300.jpg' target='_blank' class='url'>http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/15/12/24/151224160950ad231d7c54c54192_300.jpg</a>&quot;,
                &quot;count&quot;: 6
            },
            {
                &quot;userID&quot;: 937550848,
                &quot;nickName&quot;: &quot;v4aoy&quot;,
                &quot;photo&quot;: &quot;&quot;,
                &quot;count&quot;: 6
            }
        ]
    }
}</p>
<h3>6.15 春光活动-获取各种花榜单列表  </h3>
<h5>接口作者：吴小龙</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/spring/getSpringFlowersList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/spring/getSpringFlowersList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>&nbsp;</td><td>1：玉兰榜 2：牡丹榜 3：月季榜 4：海棠榜 0:春光值</td></tr><tr><td>第几周</td><td>week</td><td>否</td><td>int</td><td>&nbsp;</td><td>1：第一周，以此类推；总榜不传</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1005,1027(没有明文访问权限，必须先通过密文访问)</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>70021348</td></tr><tr><td>用户昵称</td><td>nichName</td><td>是</td><td>String</td><td>&nbsp;</td><td>干净利落</td></tr><tr><td>用户头像</td><td>photo</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>数量</td><td>count</td><td>否</td><td>Double</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果JSON示例</h4>
<p>{
    &quot;retCode&quot;: 1000,
    &quot;list&quot;: [
        {
            &quot;userID&quot;: 70021348,
            &quot;nickName&quot;: &quot;。干净利落健健康康骷髅来咯来咯&quot;,
            &quot;photo&quot;: &quot;<a href='http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/16/12/16/161216102613cc01623100aa45e7_300.jpg' target='_blank' class='url'>http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/16/12/16/161216102613cc01623100aa45e7_300.jpg</a>&quot;,
            &quot;count&quot;: 22
        },
        {
            &quot;userID&quot;: 998357628,
            &quot;nickName&quot;: &quot;松果&quot;,
            &quot;photo&quot;: &quot;<a href='http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/15/12/24/151224160950ad231d7c54c54192_300.jpg' target='_blank' class='url'>http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/15/12/24/151224160950ad231d7c54c54192_300.jpg</a>&quot;,
            &quot;count&quot;: 6
        },
        {
            &quot;userID&quot;: 937550848,
            &quot;nickName&quot;: &quot;v4aoy&quot;,
            &quot;photo&quot;: &quot;&quot;,
            &quot;count&quot;: 2
        }
    ]
}</p>
<h3>6.16 家族星活动-获取家族星活动总榜单列表  </h3>
<h5>接口作者：吴小龙</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/familyStar/getfamilyStarList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/familyStar/getfamilyStarList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1005,1027(没有明文访问权限，必须先通过密文访问)</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>房间id</td><td>roomid</td><td>是</td><td>Long</td><td>&nbsp;</td><td>70021348</td></tr><tr><td>房间名称</td><td>roomName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>房间图标</td><td>roomIcon</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>综合实力</td><td>star</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果JSON示例</h4>
<p>{
    &quot;retCode&quot;: &quot;1000&quot;,
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;familyStarList&quot;: [
        {
            &quot;roomid&quot;: 60001,
            &quot;roomName&quot;: &quot;房间名称2&quot;,
            &quot;star&quot;: 5,
            &quot;roomIcon&quot;: &quot;2.jpg&quot;
        },
        {
            &quot;roomid&quot;: 60000,
            &quot;roomName&quot;: &quot;房间名称1&quot;,
            &quot;star&quot;: 5,
            &quot;roomIcon&quot;: &quot;1.jpg&quot;
        }
    ]
}</p>
<h3>6.17 家族星活动-按时间获取家族星每日榜单列表  </h3>
<h5>接口作者：吴小龙</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/familyStar/getfamilyStarListByDate.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/familyStar/getfamilyStarListByDate.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>日期</td><td>date</td><td>是</td><td>String</td><td>20170405</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1005,1027(没有明文访问权限，必须先通过密文访问)</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>房间id</td><td>roomid</td><td>是</td><td>Long</td><td>&nbsp;</td><td>70021348</td></tr><tr><td>房间名称</td><td>roomName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>房间图标</td><td>roomIcon</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>平均用户</td><td>userCount</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>峰值用户</td><td>maxuserCount</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>人气星</td><td>popularityStar</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>消费乐币</td><td>consumTotal</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>消费星</td><td>consumStar</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果JSON示例</h4>
<p>{
    &quot;retCode&quot;: &quot;1000&quot;,
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;familyStarList&quot;: [
        {
            &quot;roomid&quot;: 60001,
            &quot;userCount&quot;: 5,
            &quot;popularityStar&quot;: 2,
            &quot;maxuserCount&quot;: 14,
            &quot;roomName&quot;: &quot;房间名称2&quot;,
            &quot;consumStar&quot;: 1,
            &quot;roomIcon&quot;: &quot;2.jpg&quot;,
            &quot;date&quot;: &quot;20170405&quot;,
            &quot;consumTotal&quot;: 10
        },
        {
            &quot;roomid&quot;: 60000,
            &quot;userCount&quot;: 2,
            &quot;popularityStar&quot;: 1,
            &quot;maxuserCount&quot;: 5,
            &quot;roomName&quot;: &quot;房间名称1&quot;,
            &quot;consumStar&quot;: 1,
            &quot;roomIcon&quot;: &quot;1.jpg&quot;,
            &quot;date&quot;: &quot;20170405&quot;,
            &quot;consumTotal&quot;: 1
        }
    ]
}</p>
<h3>6.18 IOS回归活动-查询  </h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/ioscomeback/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/ioscomeback/query.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1001,1005</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>符合设备要求</td><td>meetDevice</td><td>是</td><td>boolean</td><td>true</td><td>符合设备要求</td></tr><tr><td>符合版本要求</td><td>meetVersion</td><td>是</td><td>boolean</td><td>true</td><td>符合版本要求</td></tr><tr><td>符合产品要求</td><td>meetProductName</td><td>是</td><td>boolean</td><td>true</td><td>符合产品要求</td></tr><tr><td>用户未抽奖</td><td>userNotDraw</td><td>是</td><td>boolean</td><td>true</td><td>用户未抽奖</td></tr><tr><td>设备未抽奖</td><td>deviceNotDraw</td><td>是</td><td>boolean</td><td>true</td><td>设备未抽奖</td></tr></tbody>
</table></figure>
<h3>6.19 IOS回归活动-领取礼包  </h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/ioscomeback/draw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/ioscomeback/draw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1001,1005</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作状态</td><td>ret</td><td>否</td><td>int)</td><td>1</td><td>操作状态 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>6.20 2017夏天活动-查询抽奖次数和任务完成情况  </h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/summer2017/query_chance.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/summer2017/query_chance.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1001,1005</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>比赛进行中</td><td>inProgress</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>比赛进行中 true是 false无资格</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>是否有资格 true是 false无资格 每个设备只能一个用户抽奖</td></tr><tr><td>有效vv号</td><td>validUserID</td><td>是</td><td>String</td><td>&nbsp;</td><td>validUserID</td></tr><tr><td>剩余次数</td><td>chance</td><td>否</td><td>int</td><td>1</td><td>剩余次数</td></tr><tr><td>版本状态</td><td>versionStatus</td><td>否</td><td>int</td><td>1</td><td>版本状态 -1非IOS 0IOS版本不符合要求，未完成 1IOS版本符合要求，已完成</td></tr><tr><td>关注完成状态</td><td>follow</td><td>否</td><td>int</td><td>1</td><td>关注完成状态 0未完成 1已完成</td></tr><tr><td>评论完成状态</td><td>comment</td><td>否</td><td>int</td><td>1</td><td>评论完成状态 0未完成 1已完成</td></tr><tr><td>鲜花完成状态</td><td>flower</td><td>否</td><td>int</td><td>1</td><td>鲜花完成状态 0未完成 1已完成</td></tr><tr><td>最新上传标准完成状态</td><td>publish</td><td>否</td><td>int</td><td>1</td><td>最新上传标准完成状态 0未完成 1已完成</td></tr><tr><td>上麦时间完成状态</td><td>mictime</td><td>否</td><td>int</td><td>1</td><td>上麦时间完成状态 0未完成 1已完成</td></tr><tr><td>当前时间</td><td>time</td><td>否</td><td>long</td><td>&amp;nbps;</td><td>当前时间</td></tr></tbody>
</table></figure>
<h3>6.21 2017夏天活动-抽奖 </h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/summer2017/draw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/summer2017/draw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>抽奖活动ID</td><td>actId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>抽奖后台活动ID（东东配置）</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1001,1005</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>比赛进行中</td><td>inProgress</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>比赛进行中 true是 false无资格</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>是否有资格 true是 false无资格 每个设备只能一个用户抽奖</td></tr><tr><td>有效vv号</td><td>validUserID</td><td>是</td><td>String</td><td>&nbsp;</td><td>validUserID</td></tr><tr><td>抽奖前剩余次数</td><td>chance</td><td>否</td><td>int</td><td>&nbsp;</td><td>抽奖前剩余次数</td></tr><tr><td>是否中奖</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否中奖 1是 0否 当right<mark>true &amp;&amp; inProgress</mark>true &amp;&amp; chance&gt;0 的时候返回</td></tr><tr><td>奖品Id</td><td>giftNameId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>奖品Id 当result=1的时候返回</td></tr><tr><td>奖品名称</td><td>giftName</td><td>否</td><td>String</td><td>&nbsp;</td><td>奖品名称 当result=1的时候返回</td></tr></tbody>
</table></figure>
<h3>6.22 毕业季，与其怀念不如重温-学霸列表</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/graduation/getSuperStuList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/graduation/getSuperStuList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>日期</td><td>day</td><td>否</td><td>String</td><td>20170607</td><td>查询某一日的学霸需要带此参数</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>3</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>学霸列表</td><td>superStuList</td><td>否</td><td>List</td><td>&nbsp;</td><td>学霸列表</td></tr></tbody>
</table></figure>
<h5>学霸模型 </h5>
<pre><code>private Long userId;                //用户ID
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer cultureScore;            //文化分
private Integer majorScore;              //专业分
private Integer totalScore;             //总分
private Short level;             //学习阶段，1：小学；2：中学；3：大学；4：研究生；5：已毕业；
</code></pre>
<h3>6.23 毕业季，与其怀念不如重温-专属礼物排行榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/graduation/getSpecialGiftRank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/graduation/getSpecialGiftRank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>10</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>百科全书列表</td><td>baikeList</td><td>否</td><td>List</td><td>&nbsp;</td><td>百科全书列表</td></tr><tr><td>运动健将列表</td><td>yundongList</td><td>否</td><td>List</td><td>&nbsp;</td><td>运动健将列表</td></tr><tr><td>心灵捕手列表</td><td>xinlingList</td><td>否</td><td>List</td><td>&nbsp;</td><td>心灵捕手列表</td></tr><tr><td>交际大师列表</td><td>jiaojiList</td><td>否</td><td>List</td><td>&nbsp;</td><td>交际大师列表</td></tr></tbody>
</table></figure>
<h5>专属礼品模型 </h5>
<pre><code>private Long userId;                //用户ID
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer count;            //获得对应专属礼品的数量
</code></pre>
<h3>6.24 毕业季，与其怀念不如重温-教师榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/graduation/getTeacherList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/graduation/getTeacherList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>3</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>教师列表</td><td>teacherList</td><td>否</td><td>List</td><td>&nbsp;</td><td>教师列表</td></tr></tbody>
</table></figure>
<h5>教师模型 </h5>
<pre><code>private Long userId;                //用户ID
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer sendCount;            //送出的礼物数量
</code></pre>
<h3>6.25 毕业季，与其怀念不如重温-个人毕业季信息</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/graduation/getMyGraduation.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/graduation/getMyGraduation.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>我的毕业季信息</td><td>myGraduation</td><td>否</td><td>JSON</td><td>&nbsp;</td><td>我的毕业季信息</td></tr></tbody>
</table></figure>
<h5>myGraduation示例 </h5>
<pre><code>{
score:{cultureScore:xxx,majorScore:xxx,totalScore:xxx,level:xxx},
gift:{baikeCount:xxx,yundongCount:xxx,xinlingCount:xxx,jiaojiCount:xxx}
}
</code></pre>
<h3>6.26 个人演唱会-预告列表</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/concert/foreNoticeList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/concert/foreNoticeList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>第几期</td><td>session</td><td>是</td><td>Integer</td><td>3</td><td>第几期的活动</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>演唱会预告列表</td><td>concertList</td><td>否</td><td>List</td><td>&nbsp;</td><td>演唱会预告列表</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;concertList&quot;: [{
		&quot;nickName&quot;: &quot;70021346&quot;, //昵称
		&quot;userId&quot;: 70021346, //VV号
		&quot;roomId&quot;: 99999, //房间ID
		&quot;day&quot;: &quot;20170613&quot;, //演出日期
		&quot;startTime&quot;:1497355200000, //演出开始时间，毫秒数
		&quot;endTime&quot;:1497362400000, //演出结束时间，毫秒数
		&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/16/10/21/1610211347386fc4791fe3604cff_300.jpg&quot; //头像
	},
	{
		&quot;nickName&quot;: &quot;坦桑蓝姐姐&quot;,
		&quot;userId&quot;: 902776053,
		&quot;roomId&quot;: 88888,
		&quot;day&quot;: &quot;20170614&quot;,
		&quot;startTime&quot;:1497441600000, //演出开始时间
		&quot;endTime&quot;:1497448800000, //演出结束时间 
		&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/16/04/26/1604261652319ea39c40184842cd_300.jpg&quot;
	}]
}
</code></pre>
<h3>6.27 个人演唱会-前情回顾</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/concert/previousReview.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/concert/previousReview.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>第几期</td><td>session</td><td>是</td><td>Integer</td><td>3</td><td>第几期的活动</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>前情回顾列表</td><td>concertList</td><td>否</td><td>List</td><td>&nbsp;</td><td>前情回顾列表</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;concertList&quot;: [{
		&quot;flowerNum&quot;: 0, //鲜花数
		&quot;nickName&quot;: &quot;70021346&quot;, //昵称
		&quot;userId&quot;: 70021346, //VV号
		&quot;diamondNum&quot;: 17, //乐币数
		&quot;roomId&quot;: 99999, //房间ID
		&quot;day&quot;: &quot;20170612&quot;, //演出日期
		&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/16/10/21/1610211347386fc4791fe3604cff_300.jpg&quot;, //头像
		&quot;maxOnLine&quot;: 9 //峰值观众数
	}]
}
</code></pre>
<h3>6.28 召回活动，查看任务状态</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/recall/queryStatus.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/recall/queryStatus.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>结果 -1无资格 0未领取 1已领取</td></tr></tbody>
</table></figure>
<h3>6.29 召回活动，领取</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/recall/draw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/recall/draw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>结果 -1无资格 0失败 1成功</td></tr></tbody>
</table></figure>
<h3>6.30 夏日武林争霸战-查询四大门派人数</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/battle/getBattleMembers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/battle/getBattleMembers.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>四大门派人数</td><td>battleMembers</td><td>否</td><td>JSONObject</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;battleMembers&quot;: {&quot;xiguaCount&quot;:2,&quot;lengyinCount&quot;:2,&quot;zhapiCount&quot;:1,&quot;binggunCount&quot;:2}
}
</code></pre>
<h3>6.31 夏日武林争霸战-查询四大门派本周新锐榜和前辈榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/battle/getAllRandList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/battle/getAllRandList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>3</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>四大门派本周新锐榜和前辈榜</td><td>allRandMap</td><td>否</td><td>JSONObject</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>冷饮派本周新锐榜</td><td>lengyinWeekRankList</td><td>否</td><td>List</td><td>&nbsp;</td><td>allRandMap的元素，其他门派类似见示例</td></tr><tr><td>冷饮派前辈榜</td><td>lengyinTotalRankList</td><td>否</td><td>List</td><td>&nbsp;</td><td>allRandMap的元素，其他门派类似见示例</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;allRandMap&quot;: {
		&quot;lengyinWeekRankList&quot;: [{
			&quot;count&quot;: 2, //礼品数量
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		},
		{
			&quot;count&quot;: 1,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		}],
		&quot;xiguaTotalRankList&quot;: [{
			&quot;count&quot;: 2,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		},
		{
			&quot;count&quot;: 1,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		}],
		&quot;binggunWeekRankList&quot;: [{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		},
		{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		}],
		&quot;xiguaWeekRankList&quot;: [{
			&quot;count&quot;: 2,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		},
		{
			&quot;count&quot;: 1,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		}],
		&quot;zhapiWeekRankList&quot;: [{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		}],
		&quot;binggunTotalRankList&quot;: [{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		},
		{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		}],
		&quot;lengyinTotalRankList&quot;: [{
			&quot;count&quot;: 2,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		},
		{
			&quot;count&quot;: 1,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		}],
		&quot;zhapiTotalRankList&quot;: [{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		}]
	}
}
</code></pre>
<h3>6.32 夏日武林争霸战-查询某一门派前辈榜和各周新锐榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/battle/getMoreRandList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/battle/getMoreRandList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>50</td><td>每页的长度</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>Integer</td><td>1</td><td>1：冷饮派，2：西瓜帮，3：扎啤门，4：冰棍世家</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>某一门派前辈榜和各周新锐榜</td><td>moreRandMap</td><td>否</td><td>JSONObject</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>冰棍世家前辈榜</td><td>binggunTotalRankList</td><td>否</td><td>List</td><td>&nbsp;</td><td>moreRandMap的元素，西瓜帮是xiguaTotalRankList</td></tr><tr><td>冰棍世家第一周新锐榜</td><td>binggunWeekRankList0</td><td>否</td><td>List</td><td>&nbsp;</td><td>moreRandMap的元素，西瓜帮是xiguaWeekRankList0</td></tr><tr><td>冰棍世家第二周新锐榜</td><td>binggunWeekRankList1</td><td>否</td><td>List</td><td>&nbsp;</td><td>moreRandMap的元素，西瓜帮是xiguaWeekRankList1</td></tr><tr><td>冰棍世家第三周新锐榜</td><td>binggunWeekRankList2</td><td>否</td><td>List</td><td>&nbsp;</td><td>moreRandMap的元素，西瓜帮是xiguaWeekRankList2</td></tr><tr><td>冰棍世家第四周新锐榜</td><td>binggunWeekRankList3</td><td>否</td><td>List</td><td>&nbsp;</td><td>moreRandMap的元素，西瓜帮是xiguaWeekRankList3</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;moreRandMap&quot;: {
		&quot;binggunTotalRankList&quot;: [{
			&quot;count&quot;: 3, //礼品数量
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		},
		{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		},
		{
			&quot;count&quot;: 1,
			&quot;nickName&quot;: &quot;提高膜所以监督检查金外婆去上学&quot;,
			&quot;userId&quot;: 600034,
			&quot;maxUpdateTime&quot;: 1499069191000,
			&quot;photo&quot;: &quot;&quot;
		}],
		&quot;binggunWeekRankList0&quot;: [{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;600040&quot;,
			&quot;userId&quot;: 600040,
			&quot;maxUpdateTime&quot;: 1498730405000,
			&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
		},
		{
			&quot;count&quot;: 3,
			&quot;nickName&quot;: &quot;师兄&quot;,
			&quot;userId&quot;: 20001,
			&quot;maxUpdateTime&quot;: 1498730416000,
			&quot;photo&quot;: &quot;&quot;
		},
		{
			&quot;count&quot;: 1,
			&quot;nickName&quot;: &quot;提高膜所以监督检查金外婆去上学&quot;,
			&quot;userId&quot;: 600034,
			&quot;maxUpdateTime&quot;: 1499069191000,
			&quot;photo&quot;: &quot;&quot;
		}]
	}
}
</code></pre>
<h3>6.33 夏日武林争霸战-查询高手榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/battle/getMasterHandRandList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/battle/getMasterHandRandList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>高手榜</td><td>masterHandRandList</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;masterHandRandList&quot;: [{
		&quot;count&quot;: 104, //清凉值
		&quot;nickName&quot;: &quot;提高膜所以监督检查金外婆去上学&quot;,
		&quot;userId&quot;: 600034,
		&quot;maxUpdateTime&quot;: 1499069191000,
		&quot;photo&quot;: &quot;&quot;
	},
	{
		&quot;count&quot;: 10,
		&quot;nickName&quot;: &quot;师兄&quot;,
		&quot;userId&quot;: 20001,
		&quot;maxUpdateTime&quot;: 1498730416000,
		&quot;photo&quot;: &quot;&quot;
	},
	{
		&quot;count&quot;: 5,
		&quot;nickName&quot;: &quot;600040&quot;,
		&quot;userId&quot;: 600040,
		&quot;maxUpdateTime&quot;: 1498730405000,
		&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
	}]
}
</code></pre>
<h3>6.34 夏日武林争霸战-查询传功榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/battle/getTeacherList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/battle/getTeacherList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>传功榜</td><td>teacherList</td><td>否</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;teacherList&quot;: [{
		&quot;count&quot;: 2, //送给多少人
		&quot;nickName&quot;: &quot;600040&quot;,
		&quot;userId&quot;: 600040,
		&quot;maxUpdateTime&quot;: 1499071238000,
		&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
	},
	{
		&quot;count&quot;: 2,
		&quot;nickName&quot;: &quot;师兄&quot;,
		&quot;userId&quot;: 20001,
		&quot;maxUpdateTime&quot;: 1499071244000,
		&quot;photo&quot;: &quot;&quot;
	},
	{
		&quot;count&quot;: 1,
		&quot;nickName&quot;: &quot;提高膜所以监督检查金外婆去上学&quot;,
		&quot;userId&quot;: 600034,
		&quot;maxUpdateTime&quot;: 1499069231000,
		&quot;photo&quot;: &quot;&quot;
	}]
}
</code></pre>
<h3>6.35 夏日武林争霸战-查询个人信息</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/battle/getMyBattle.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/battle/getMyBattle.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>个人信息</td><td>myBattle</td><td>否</td><td>JsonObject</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;myBattle&quot;: {
		&quot;bingfenghuang&quot;: 0,
		&quot;binggun&quot;: 3, //获得的冰棍数量
		&quot;lengyin&quot;: 2,
		&quot;score&quot;: 10, //清凉值
		&quot;xigua&quot;: 2,
		&quot;zhapi&quot;: 3
	}
}
</code></pre>
<p>&nbsp;</p>
<h3>6.36 厨神活动-做菜</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/cook.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/cook.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>状态</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>状态 1成功 0失败 -1没有做菜资格</td></tr><tr><td>菜谱ID</td><td>menuID</td><td>否</td><td>int</td><td>&nbsp;</td><td>菜谱ID</td></tr><tr><td>菜谱名称</td><td>menuName</td><td>否</td><td>String</td><td>&nbsp;</td><td>菜谱名称</td></tr><tr><td>增加厨艺值</td><td>addCook</td><td>否</td><td>int</td><td>&nbsp;</td><td>增加厨艺值</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>6.37 厨神活动-厨神（食神）榜</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/rank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/rank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>type</td><td>类型</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>类型 1厨神 2食神</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>榜单列表</td><td>rankList</td><td>否</td><td>json</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>用户信息 ActivityCookUserInfo</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long food;                  //食材数
private Long flavor;                //调味数
private Integer cook;               //厨艺值
private Integer eat;                //美食值
private Short menuNum;              //菜谱数量
private Short cookLevel;            //厨艺等级
private String cookLevelName;       //厨艺等级名称
private Short eatLevel;             //美食等级
private String eatLevelName;        //美食等级名称
private Integer rank;               //排名
</code></pre>
<p>&nbsp;</p>
<h3>6.38 厨神活动-用户信息</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/userInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/userInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>用户信息</td><td>userInfo</td><td>否</td><td>json</td><td>&nbsp;</td><td>用户信息</td></tr></tbody>
</table></figure>
<h5>用户信息 ActivityCookUserInfo</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long food;                  //食材数
private Long flavor;                //调味数
private Integer cook;               //厨艺值
private Integer eat;                //美食值
private Short menuNum;              //菜谱数量
private Short cookLevel;            //厨艺等级
private String cookLevelName;       //厨艺等级名称
private Short eatLevel;             //美食等级
private String eatLevelName;        //美食等级名称
private Integer rank;               //排名
</code></pre>
<h3>6.39 厨神活动-用户菜谱</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/userMenu.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/userMenu.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>用户菜谱</td><td>userMenuList</td><td>否</td><td>json</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>用户菜谱模型 ActivityCookUserMenu</h5>
<pre><code>private Integer menuID;             //菜谱ID
private String menulName;           //菜谱名称
private Integer amount;             //数量
</code></pre>
<h3>6.40 厨神活动-菜谱赠送</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/give.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/give.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>被赠送用户ID</td><td>toUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>被赠送用户ID</td></tr><tr><td>菜谱ID</td><td>menuID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>菜谱ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>状态</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>状态 //结果 1成功 0失败 -1用户没有这个菜谱</td></tr></tbody>
</table></figure>
<h3>6.41 厨神活动-菜谱赠送(接受赠送)记录</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/menuGiveLog.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/menuGiveLog.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>type</td><td>类型</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>类型 1赠送 2接受赠送</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>菜谱赠送日志</td><td>menuLogList</td><td>否</td><td>json</td><td>&nbsp;</td><td>菜谱赠送日志</td></tr></tbody>
</table></figure>
<h5>用户菜谱模型 ActivityCookMenuLog</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private Long toUserID;              //被赠送用户
private String toUserNickName;      //被赠送用户昵称
private Integer menuID;             //菜谱ID
private String menulName;           //菜谱名称
</code></pre>
<h3>6.42 厨神活动-单项第一</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/topByDay.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/topByDay.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>dateType</td><td>类型</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>日期类型 1今天 2昨天</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>厨艺单项第一</td><td>cookTop</td><td>否</td><td>json</td><td>&nbsp;</td><td>厨艺单项第一</td></tr><tr><td>美食单项第一</td><td>eatTop</td><td>否</td><td>json</td><td>&nbsp;</td><td>美食单项第一</td></tr><tr><td>做菜数量单项第一</td><td>menuTop</td><td>否</td><td>json</td><td>&nbsp;</td><td>做菜数量单项第一</td></tr></tbody>
</table></figure>
<h5>单项信息 ActivityCookSingleRank</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer value;              //值
private Integer rank;               //排名
</code></pre>
<h3>6.43 厨神活动-单项榜单</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/cook/rankByDay.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/cook/rankByDay.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>dateType</td><td>类型</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>日期类型 1今天 2昨天</td></tr><tr><td>type</td><td>类型</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>类型 1厨艺值 2做菜数量 3美食值</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>单项榜单</td><td>singleRankList</td><td>否</td><td>json</td><td>&nbsp;</td><td>单项榜单</td></tr></tbody>
</table></figure>
<h5>单项信息 ActivityCookSingleRank</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Integer value;              //值
private Integer rank;               //排名
</code></pre>
<h3>6.44 马拉松活动-查询日跑榜或奔跑总榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/marathon/getRunList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/marathon/getRunList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>日期</td><td>day</td><td>否</td><td>String</td><td>20170607</td><td>查询日跑榜需要带此参数</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>3</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>榜单列表</td><td>runList</td><td>否</td><td>List</td><td>&nbsp;</td><td>榜单列表</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;runList&quot;: [{
		&quot;level&quot;: 1,  //选手级别：0暂无 1短跑选手 2长跑选手 3半马选手 4全马选手 5马拉松完成
		&quot;mileage&quot;: 115,  //跑程（米）
		&quot;nickName&quot;: &quot;师兄&quot;,  //昵称
		&quot;userId&quot;: 20001,  //用户ID，即VV号
		&quot;score&quot;: 10,  //训练度
		&quot;photo&quot;: &quot;&quot;  //头像
	},
	{
		&quot;level&quot;: 0,
		&quot;mileage&quot;: 11,
		&quot;nickName&quot;: &quot;600040&quot;,
		&quot;userId&quot;: 600040,
		&quot;score&quot;: 20,
		&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;
	}]
}
</code></pre>
<h3>6.45 马拉松活动-查询加油榜</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/marathon/getSenderList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/marathon/getSenderList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>3</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>榜单列表</td><td>senderList</td><td>否</td><td>List</td><td>&nbsp;</td><td>榜单列表</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;senderList&quot;: [{
		&quot;nickName&quot;: &quot;HD&quot;,
		&quot;updateTime&quot;: 1504250844000,
		&quot;sendCount&quot;: 1, //给多少人送了礼物
		&quot;userId&quot;: 99018546,
		&quot;photo&quot;: &quot;&quot;
	},
	{
		&quot;nickName&quot;: &quot;705126815&quot;,
		&quot;updateTime&quot;: 1504250902000,
		&quot;sendCount&quot;: 1,
		&quot;userId&quot;: 705126815,
		&quot;photo&quot;: &quot;&quot;
	}]
}
</code></pre>
<h3>6.46 马拉松活动-查询用户的马拉松信息</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/marathon/getMyMarathon.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/marathon/getMyMarathon.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>我的马拉松信息</td><td>myMarathon</td><td>否</td><td>JSON</td><td>&nbsp;</td><td>我的马拉松信息</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;myMarathon&quot;: {
		&quot;dacall&quot;: 5, //收到的打call数量
		&quot;drink&quot;: 2, //收到的能量特饮数量
		&quot;level&quot;: 1, //选手级别
		&quot;mileage&quot;: 115, //跑程
		&quot;score&quot;: 10, //训练度
		&quot;userId&quot;: 20001,
		&quot;weiwu&quot;: 2 //收到的V587数量
	}
}
</code></pre>
<h3>6.47 一周大咖秀-查询本周榜单</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/bigshots/getBigShotsListWeek.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/bigshots/getBigShotsListWeek.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>3</td><td>每页的长度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>魅力榜</td><td>meiLiList</td><td>否</td><td>List</td><td>&nbsp;</td><td>魅力榜</td></tr><tr><td>人气榜</td><td>renQiList</td><td>否</td><td>List</td><td>&nbsp;</td><td>人气榜</td></tr><tr><td>爱唱榜</td><td>aiChangList</td><td>否</td><td>List</td><td>&nbsp;</td><td>爱唱榜</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;meiLiList&quot;: [{
	&quot;nickName&quot;: &quot;路飞儿&quot;,
	&quot;totalCount&quot;: 2000,
	&quot;userId&quot;: 901027853,
	&quot;lastTime&quot;: 1510131139000,
	&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/17/04/13/1704131555376e5cf3f47133408a_300.jpg&quot;
	},
	{
		&quot;nickName&quot;: &quot;小vv&quot;,
		&quot;totalCount&quot;: 10,
		&quot;userId&quot;: 900001466,
		&quot;lastTime&quot;: 1510044723000,
		&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/17/04/18/170418164856e505498cf9264a30_300.jpg&quot;
	}],
	&quot;renQiList&quot;: [{
		结构和魅力榜相同
	}],
	&quot;aiChangList&quot;: [{
		结构和魅力榜相同
	}]
}
</code></pre>
<h3>6.48 一周大咖秀-查询历史榜单</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/bigshots/getBigShotsListHistory.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/bigshots/getBigShotsListHistory.htm</a></p>
<h4>请求参数</h4>
<p>无 </p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>历史榜单</td><td>bigShotsListHistory</td><td>否</td><td>list</td><td>&nbsp;</td><td>历史榜单</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;bigShotsListHistory&quot;: [{
		&quot;renqiCount&quot;: 240, //人气指数
		&quot;changjiangUserId&quot;: 900713489,
		&quot;updateTime&quot;: 1510193255000,
		&quot;meiliPhoto&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/09/18/17091816561685ba809d623f423e_300.jpg&quot;,
		&quot;renqiNickName&quot;: &quot;无敌小姐姐飞哥哈哈哈嘎嘎嘎海海&quot;, //人气昵称
		&quot;changjiangNickName&quot;: &quot;V音乐V good＆♤♡◇♧&quot;,
		&quot;changjiangCount&quot;: 372,
		&quot;renqiUserId&quot;: 901674311, //人气用户ID
		&quot;meiliUserId&quot;: 70021348,
		&quot;meiliNickName&quot;: &quot;。干净利落健健康康骷髅来咯😊&quot;,
		&quot;renqiPhoto&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/04/24/17042409135448049348336d416a_300.jpg&quot;, //人气头像
		&quot;yearWeek&quot;: &quot;2017_45&quot;,
		&quot;changjiangPhoto&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/04/21/170421145708525ab43cd380489b_300.jpg&quot;,
		&quot;meiliCount&quot;: 956
	},
	{
		&quot;renqiCount&quot;: 380,
		&quot;changjiangUserId&quot;: 70021348,
		&quot;updateTime&quot;: 1510193186000,
		&quot;meiliPhoto&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/05/19/1705191812176570b38319e54d55_300.jpg&quot;,
		&quot;renqiNickName&quot;: &quot;路飞儿&quot;,
		&quot;changjiangNickName&quot;: &quot;。干净利落健健康康骷髅来咯😊&quot;,
		&quot;changjiangCount&quot;: 425,
		&quot;renqiUserId&quot;: 901027853,
		&quot;meiliUserId&quot;: 600040,
		&quot;meiliNickName&quot;: &quot;600040&quot;,
		&quot;renqiPhoto&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/04/13/1704131555376e5cf3f47133408a_300.jpg&quot;,
		&quot;yearWeek&quot;: &quot;2017_44&quot;,
		&quot;changjiangPhoto&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/09/18/17091816561685ba809d623f423e_300.jpg&quot;,
		&quot;meiliCount&quot;: 2560
	}]
}
</code></pre>
<p>&nbsp;</p>
<h3>6.49 一周大咖秀-查询用户的大咖秀信息</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/bigshots/getMyBigShots.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/bigshots/getMyBigShots.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>88888888</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>我的大咖信息</td><td>myBigShots</td><td>否</td><td>JSON</td><td>&nbsp;</td><td>我的大咖信息</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果示例 </h4>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;myBigShots&quot;: {
		&quot;renqiCount&quot;: 32, //人气指数
		&quot;aichangCount&quot;: 0, //爱唱指数
		&quot;userId&quot;: 70021348, //用户ID
		&quot;diamondCount&quot;: 0 //获得乐币数
	}
}
</code></pre>
<h3>6.50 2017风云活动，推荐人</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/fengyun/recommendUser.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/recommendUser.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>被推荐人</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>被推荐人</td></tr><tr><td>推荐人</td><td>recommendUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>推荐人</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>1成功 -1推荐人歌手等级没超过10级 -2被推荐人不满足发歌条件 -3不在活动时间内 -4已经推荐过 -5被推荐者已被取消资格</td></tr></tbody>
</table></figure>
<h3>6.51 2017风云活动，投票</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/fengyun/voteTicket.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/voteTicket.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>投票人</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>投票人</td></tr><tr><td>被投票人</td><td>toUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>被投票人</td></tr><tr><td>投票人设备Id</td><td>deviceId</td><td>是</td><td>String</td><td>&nbsp;</td><td>投票人设备Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>1成功 -1被投票人无资格 -2投票机会已用完 -3不在活动时间内</td></tr></tbody>
</table></figure>
<h3>6.52 2017风云活动，查询候选列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/fengyun/getCandidateList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/getCandidateList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>userList</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr><tr><td>总记录数</td><td>recordCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>总记录数</td></tr></tbody>
</table></figure>
<h5>风云活动模型 Activity2017FengyunResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long ticketNum;             //票数
private Long recommendNum;          //推荐票数
private Short status;               //用户参赛状态 -1或者0未参赛 1候选 2入选
private Integer rank;               //排名
</code></pre>
<h3>6.53 2017风云活动，查询入围列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/fengyun/getQualificationList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/getQualificationList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>userList</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr><tr><td>总记录数</td><td>recordCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>总记录数</td></tr></tbody>
</table></figure>
<h5>风云活动模型 Activity2017FengyunResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long ticketNum;             //票数
private Long recommendNum;          //推荐票数
private Short status;               //用户参赛状态 -1或者0未参赛 1候选 2入选
private Integer rank;               //排名
</code></pre>
<h3>6.54 2017风云活动，查询决赛列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/fengyun/getFinalList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/getFinalList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>userList</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr><tr><td>总记录数</td><td>recordCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>总记录数</td></tr></tbody>
</table></figure>
<h5>风云活动模型 Activity2017FengyunResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long ticketNum;             //票数
private Long recommendNum;          //推荐票数
private Short status;               //用户参赛状态 -1或者0未参赛 1候选 2入选
private Integer rank;               //排名
</code></pre>
<h3>6.55 2017风云活动，查询今日上升最快列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/fengyun/getTodayTopList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/getTodayTopList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>userList</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr><tr><td>总记录数</td><td>recordCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>总记录数</td></tr></tbody>
</table></figure>
<h5>风云活动模型 Activity2017FengyunResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long ticketNum;             //票数
private Long recommendNum;          //推荐票数
private Short status;               //用户参赛状态 -1或者0未参赛 1候选 2入选
private Integer rank;               //排名
</code></pre>
<h3>6.56 2017风云活动，查找用户</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/fengyun/findUser.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/fengyun/findUser.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户信息</td><td>user</td><td>是</td><td>json</td><td>&nbsp;</td><td>用户信息</td></tr></tbody>
</table></figure>
<h5>风云活动模型 Activity2017FengyunResult</h5>
<pre><code>private Long userID;                //用户
private String nickName;            //用户昵称
private String photo;               //用户头像
private Long ticketNum;             //票数
private Long recommendNum;          //推荐票数
private Short status;               //用户参赛状态 -1或者0未参赛 1候选 2入选
</code></pre>
<h3>6.57 我的音乐2017</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/mymusic2017/queryUser.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/mymusic2017/queryUser.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户信息</td><td>user</td><td>是</td><td>json</td><td>&nbsp;</td><td>用户信息</td></tr></tbody>
</table></figure>
<h5>我的音乐2017模型 MyMusic2017Result</h5>
<pre><code>private Long userID;               //用户ID
private String nickName;           //用户昵称
private String photo;              //用户头像

private Long AVID;                 //第一首作品ID
private MyMusic2017ZpResult firstZp; //第一首作品

private Integer days;              //在线天数
private Date startDate;            //最长不在线开始日期
private Date endDate;              //最长不在线结束日期

private Date roomDate;             //登录房间的日期
private Integer roomID;            //房间ID
private String roomName;           //房间名称
private Integer minutes;           //最长一次登录房间的分钟数

private Long fansUserID;           //忠实粉丝
private String fansNickName;       //忠实粉丝昵称
private String fansPhoto;          //忠实粉丝头像
private Long cpUserID;             //合唱CP
private String cpNickName;         //合唱CP昵称
private String cpPhoto;            //合唱CP头像
private Long moneyUserID;          //金主爸爸
private String moneyNickName;      //金主爸爸昵称
private String moneyPhoto;         //金主爸爸头像

private Long fansNum;              //年度粉丝数
private Long followNum;            //年度关注数
private Long commentNum;           //年度评论
private Long praiseNum;            //年度点赞
private Long flowerNum;            //年度鲜花
private Long diamondNum;           //年度乐币
private Long zpNum;                //年度作品数
private Long recommendNum;         //年度推荐数

private Long totalFansNum;         //总粉丝数
private Long totalFollowNum;       //总关注数
private Long totalDiamondNum;      //总乐币

private Long zp1;                  //最热作品1
private Long zp2;                  //最热作品2
private Long zp3;                  //最热作品3
private Long zp4;                  //最热作品4
private Long zp5;                  //最热作品5
private List&lt;MyMusic2017ZpResult&gt; topZps; //作品列表

private Short status;              //状态
</code></pre>
<h5>我的音乐2017作品模型 MyMusic2017ZpResult</h5>
<pre><code>private Long AVID;               //AVID
private String name;             //名字
private Short status;            //状态 0初始 2审核通过 4审核不通过或删除
private String photo;            //用户头像
private String fileUrl;          //文件路径
private Short fileType;          //类型 4视频 其他音频
private Date createTime;         //上传时间(new)
</code></pre>
<h3>6.58 地表最强音-查询战队列表</h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/earth/getEarthVoiceList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/earth/getEarthVoiceList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>阶段</td><td>level</td><td>是</td><td>Short</td><td>&nbsp;</td><td>比赛阶段 1排位赛 2八强 3四强 4两强 5冠军</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>战队列表</td><td>earthVoiceList</td><td>否</td><td>list</td><td>&nbsp;</td><td>战队列表</td></tr></tbody>
</table></figure>
<h4>返回结果示例 </h4>
<pre><code>[
	{
		&quot;energy&quot;: 11900, //能量值
		&quot;level&quot;: 1, //比赛阶段
		&quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/12/20/1712201445114874ee5841cb4728_300.gif&quot;, //战队头像
		&quot;spaceUserSimpleList&quot;: [{ //战队成员列表
			&quot;nickname&quot;: &quot;V音乐V good＆♤♡◇♧&quot;,
			&quot;photo2&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/17/04/21/170421145708525ab43cd380489b_300.jpg&quot;, //成员头像
			&quot;userID&quot;: 900713489
		},
		{
			&quot;nickname&quot;: &quot;小陈陈ぃ&quot;,
			&quot;photo2&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/16/04/25/160425112027d0e280c89cf048b3_300.jpg&quot;,
			&quot;userID&quot;: 906460218
		}],
		&quot;teamId&quot;: 1, //战队ID
		&quot;teamName&quot;: &quot;爱之歌&quot;, //战队名称
		&quot;updateTime&quot;: 1515393750000,
		&quot;userIds&quot;: &quot;900713489,906460218&quot; //战队成员ID列表
	},
	...
]
</code></pre>
<h3>6.59 旺旺大礼，幸运翻牌-查询抽奖次数和任务完成情况  </h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/wangwang/query_chance.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/wangwang/query_chance.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1001,1005</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>比赛进行中</td><td>inProgress</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>比赛进行中 true是 false无资格</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>是否有资格 true是 false无资格 每个设备只能一个用户抽奖</td></tr><tr><td>有效vv号</td><td>validUserID</td><td>是</td><td>String</td><td>&nbsp;</td><td>validUserID</td></tr><tr><td>剩余次数</td><td>chance</td><td>是</td><td>int</td><td>1</td><td>剩余次数</td></tr><tr><td>分享完成状态</td><td>share</td><td>否</td><td>int</td><td>1</td><td>分享完成状态 0未完成 1已完成</td></tr><tr><td>评论完成状态</td><td>comment</td><td>否</td><td>int</td><td>1</td><td>评论完成状态 0未完成 1已完成</td></tr><tr><td>鲜花完成状态</td><td>flower</td><td>否</td><td>int</td><td>1</td><td>鲜花完成状态 0未完成 1已完成</td></tr><tr><td>最新上传标准完成状态</td><td>publish</td><td>否</td><td>int</td><td>1</td><td>最新上传标准完成状态 0未完成 1已完成</td></tr><tr><td>点赞完成状态</td><td>praise</td><td>否</td><td>int</td><td>1</td><td>点赞完成状态 0未完成 1已完成</td></tr><tr><td>当前时间</td><td>time</td><td>否</td><td>long</td><td>&amp;nbps;</td><td>当前时间</td></tr></tbody>
</table></figure>
<h3>6.60 旺旺大礼，幸运翻牌-抽奖 </h3>
<h5>接口作者：赵玉杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/wangwang/draw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/wangwang/draw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>抽奖活动ID</td><td>actId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>抽奖后台活动ID（东东配置）</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值, 1000,1001,1005</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>比赛进行中</td><td>inProgress</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>比赛进行中 true是 false无资格</td></tr><tr><td>是否有资格</td><td>right</td><td>是</td><td>boolean</td><td>&nbsp;</td><td>是否有资格 true是 false无资格 每个设备只能一个用户抽奖</td></tr><tr><td>有效vv号</td><td>validUserID</td><td>是</td><td>String</td><td>&nbsp;</td><td>validUserID</td></tr><tr><td>抽奖前剩余次数</td><td>chance</td><td>否</td><td>int</td><td>&nbsp;</td><td>抽奖前剩余次数</td></tr><tr><td>是否中奖</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否中奖 1是 0否 当right<mark>true &amp;&amp; inProgress</mark>true &amp;&amp; chance&gt;0 的时候返回</td></tr><tr><td>奖品Id</td><td>giftNameId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>奖品Id 当result=1的时候返回</td></tr><tr><td>奖品名称</td><td>giftName</td><td>否</td><td>String</td><td>&nbsp;</td><td>奖品名称 当result=1的时候返回</td></tr></tbody>
</table></figure>
<h3>6.61 和你一起唱活动，查询歌手列表</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getSingerList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getSingerList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>List</td><td>&nbsp;</td><td>歌手列表</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900000167,               // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,                // 用户名称
		&quot;hotValue&quot;: 127232,                // 热度值
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;,  // 头像
		&quot;color&quot;:1,            // 1紫色 2蓝色 3黄色
		&quot;avList&quot;: [{                       // 半成品列表
			&quot;chorusTotal&quot;: 2178932,        // 合唱人数
			&quot;KSCSongID&quot;:1212,
			&quot;avName&quot;: &quot;传奇&quot;,              // 半成品名称
			&quot;avID&quot;: 1                      // 半成品ID
		}]
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.62 和你一起唱活动，获取AV合唱详情</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getAVChorusDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getAVChorusDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>半成品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>半成品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	{
    	&quot;result&quot;: {
    		&quot;chorusTotal&quot;: 12318,          // 合唱人数
    		&quot;avName&quot;: &quot;传奇&quot;,              // 半成品名称
    		&quot;avID&quot;: 1                      // 半成品ID
    	},
    	&quot;retCode&quot;: 1000
    }
}
</code></pre>
<h3>6.63 和你一起唱活动，查询歌手作品热度榜</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVHeatRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVHeatRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>半成品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>半成品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900000167,                 // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,                  // 用户名称
		&quot;hotValue&quot;: 18972,                   // 热度值
		&quot;viewCount&quot;: 9278,                   // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;     // 头像
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.64 和你一起唱活动，查询歌手作品最新上传列表</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>半成品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>半成品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900000167,        // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,         // 用户名称
		&quot;timeLabel&quot;: &quot;刚刚上传&quot;,    // 时间
		&quot;viewCount&quot;: 9278,          // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;  // 头像
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.65 和你一起唱活动，查询总榜热度排行榜</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVHeatRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVHeatRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900000167,                 // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,                  // 用户名称
		&quot;hotValue&quot;: 18972,                   // 热度值
		&quot;viewCount&quot;: 9278,                   // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;     // 头像
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.66 和你一起唱活动，查询总榜最新上传列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900000167,        // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,         // 用户名称
		&quot;timeLabel&quot;: &quot;刚刚上传&quot;,    // 时间
		&quot;viewCount&quot;: 9278,          // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;  // 头像
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.67 和你一起唱活动，总榜底部查询自己作品</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getOwnSpaceAvInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getOwnSpaceAvInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
		resultData: {
		userId: 900002773,
		hotValue: 104019,
		avName: &quot;死了都要爱&quot;,
		userImg: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/07/16/180716144818c269a57f6cdd42fd.jpg&quot;
		}
	},
	retCode: 1000
}
</code></pre>
<h3>6.68 </h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='http://music.51vv.com/sodnew/activity/origin/getOriginSingerList.htm?parameter=' target='_blank' class='url'>http://music.51vv.com/sodnew/activity/origin/getOriginSingerList.htm?parameter=</a>{userID:900002773}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				relationType: 2, --关系状态。
								--0：无效，
								--1：关注（user 关注了 target）
								--2：好友（互相关注）&#39;
								--3：被关注（target 关注了 user）
				singerUserID: 7848965,--歌手的userID
				singerName: &quot;胡芳芳&quot;,--歌手名
				singerDesc: &quot;胡芳芳&quot;,--歌手简介
				singerImg: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/chorus/situlanfang.png&quot;--歌手图片
			}
		],
	retCode: 1000
}

</code></pre>
<h3>6.69 和你一起唱活动，活动主题颜色</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getActivityThemeConfig.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getActivityThemeConfig.htm?parameter=</a>{&#39;activityID&#39;:2172}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动Id</td><td>activityID</td><td>是</td><td>long</td><td>2172</td><td>活动配置ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>活动主题配置</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
 result:{
		activityID:2172                                     // &#39;活动Id&#39;,
        activityHeadImg:&quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/07/16/180716144818c269a57f6cdd42fd.jpg&quot;//活动头图&#39;,
        backgroundColor:&quot;1233334&quot;                           //页面底色,
        buttonColor:&quot;234445&quot;                                 //按钮颜色,
        borderColor:&quot;222&quot;                                   //边框颜色,
        borderInnerBackground:&quot;222&quot;                         //边框内底色,
        fontColor:&quot;222&quot;                                    //字体颜色,
			} 
		,
	retCode: 1000
}

</code></pre>
<h3>6.70 和你一起唱活动，活动奖励配置</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getActivityRewardConfig.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getActivityRewardConfig.htm?parameter=</a>{&#39;activityID&#39;:2172}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动Id</td><td>activityID</td><td>是</td><td>long</td><td>2172</td><td>活动配置ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>活动奖励配置</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
 result:[{top:1//序号,
          topName:&quot;1&quot;//名次展示,
          topReward:&quot;4000乐币+3个月限量尊贵VIP特权&quot;},
          {top:2//序号,
          topName:&quot;2-5&quot;//名次展示,
          topReward:&quot;3000乐币+2个月限量尊贵VIP特权&quot;},
          {top:3//序号,
          topName:&quot;6-10&quot;//名次展示,
          topReward:&quot;2000乐币+1个月限量尊贵VIP特权&quot;}] 
		,
	retCode: 1000
}

</code></pre>
<h3>6.71 和你一起唱活动，查询总榜热度排行榜 （新增-添加字段）</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVHeatChorusRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVHeatChorusRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;:{
	&quot;totalCount&quot;: 100,
	&quot;spaceAvList&quot;: [{
        &quot;userID&quot;: 900000167,                 // 用户ID
        &quot;userName&quot;: &quot;测试&quot;,                  // 用户名称
        &quot;hotValue&quot;: 18972,                   // 热度值
        &quot;viewCount&quot;: 9278,                   // 听过人数
        &quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;     // 头像
    }]
	},
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.72 和你一起唱活动，查询总榜最新上传列表 （新增-添加字段）</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVChorusRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVChorusRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;:{
    &quot;totalCount&quot;: 100，
    &quot;spaceAvList&quot;: [{
		&quot;userID&quot;: 900000167,        // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,         // 用户名称
		&quot;timeLabel&quot;: &quot;刚刚上传&quot;,    // 时间
		&quot;viewCount&quot;: 9278,          // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;  // 头像
	}]
    },
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.73 和你一起唱活动，查询总榜热度排行榜 （新增-添加字段）</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVChorusHeatRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getTotalSpaceAVChorusHeatRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: {
    &quot;totalCount&quot;: 100，
    &quot;spaceAvList&quot;:[{
		&quot;userID&quot;: 900000167,                 // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,                  // 用户名称
		&quot;hotValue&quot;: 18972,                   // 热度值
		&quot;viewCount&quot;: 9278,                   // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;     // 头像
	}]
    },
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.74 和你一起唱活动，查询歌手作品热度榜（新增-添加字段）</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVChorusHeatRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVChorusHeatRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>半成品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>半成品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;:{
    &quot;totalCount&quot;: 100，
    &quot;spaceAvList&quot;: [{
		&quot;userID&quot;: 900000167,                 // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,                  // 用户名称
		&quot;hotValue&quot;: 18972,                   // 热度值
		&quot;viewCount&quot;: 9278,                   // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;     // 头像
	}]
     },
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>6.75 和你一起唱活动，查询歌手作品最新上传列表（新增-添加字段）</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVChorusRankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/chorus/getSingerSpaceAVChorusRankList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>半成品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>半成品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900000167,        // 用户ID
		&quot;userName&quot;: &quot;测试&quot;,         // 用户名称
		&quot;timeLabel&quot;: &quot;刚刚上传&quot;,    // 时间
		&quot;viewCount&quot;: 9278,          // 听过人数
		&quot;userImg&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/06/07/180607154753655feb5eac59411d.jpg&quot;  // 头像
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3>7.1、作品今日最火榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/zp_24h.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/zp_24h.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品排行</td><td>spaceAvRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品排行,前99行记录</td></tr></tbody>
</table></figure>
<h5>作品排行模型 SpaceAvRank</h5>
<pre><code>private Long AVID;                    //作品ID
private String name;                  //作品名称
private Long hot;                     //热度值
private Short fileType;               //文件类型 1歌曲 4MV
private Short exFileType;             //扩展文件类型 0独唱 1合唱 2发起合唱
private Integer rank;                 //排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private Integer authType;             //认证状态 -1未认证 0普通用户 1明星
private Short singerLevel;            //歌手等级
private String imgUrl;                //等级图片
private Integer vip;                  //是否是会员 1是 2不是
</code></pre>
<h3>7.2、作品30天榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/zp_30d.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/zp_30d.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品排行</td><td>spaceAvRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品排行</td></tr></tbody>
</table></figure>
<h5>作品排行模型 SpaceAvRank</h5>
<pre><code>private Long AVID;                    //作品ID
private String name;                  //作品名称
private Long hot;                     //热度值
private Short fileType;               //文件类型 1歌曲 4MV
private Short exFileType;             //扩展文件类型 0独唱 1合唱 2发起合唱
private Integer rank;                 //排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private Integer authType;             //认证状态 -1未认证 0普通用户 1明星
private Short singerLevel;            //歌手等级
private String imgUrl;                //等级图片
private Integer vip;                  //是否是会员 1是 2不是
</code></pre>
<h3>7.3、用户7天榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/user_7d.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/user_7d.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户排行</td><td>spaceUserRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户排行</td></tr></tbody>
</table></figure>
<h5>用户排行模型 SpaceUserRank</h5>
<pre><code>private Long hot;                     //热度值
private Integer rank;                 //排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private Integer authType;             //认证状态 -1未认证 0普通用户 1明星
private Short singerLevel;            //歌手等级
private String imgUrl;                //等级图片
private Integer vip;                  //是否是会员 1是 2不是
</code></pre>
<h3>7.4、用户总榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/user_total.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/user_total.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户排行</td><td>spaceUserRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户排行</td></tr></tbody>
</table></figure>
<h5>用户排行模型 SpaceUserRank</h5>
<pre><code>private Long hot;                     //热度值
private Integer rank;                 //排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private Integer authType;             //认证状态 -1未认证 0普通用户 1明星
private Short singerLevel;            //歌手等级
private String imgUrl;                //等级图片
private Integer vip;                  //是否是会员 1是 2不是
</code></pre>
<h3>7.5、财富日榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/wealth_24h.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/wealth_24h.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户排行</td><td>wealthRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户排行</td></tr></tbody>
</table></figure>
<h5>财富排行模型</h5>
<pre><code>private Integer rankingNo;            //当前排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private String level;                 //等级
private Integer vip;                  //是否是会员 1是 2不是
private Integer wealth;               //消费乐币数量
</code></pre>
<h3>7.6、财富周榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/wealth_7d.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/wealth_7d.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户排行</td><td>wealthRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户排行</td></tr></tbody>
</table></figure>
<h5>财富排行模型</h5>
<pre><code>private Integer rankingNo;            //当前排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private String level;                 //等级
private Integer vip;                  //是否是会员 1是 2不是
private Integer wealth;               //消费乐币数量
</code></pre>
<h3>7.7、财富总榜</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/common/wealth_total.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/common/wealth_total.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>用户排行</td><td>wealthRanks</td><td>否</td><td>List</td><td>&nbsp;</td><td>用户排行</td></tr></tbody>
</table></figure>
<h5>财富排行模型</h5>
<pre><code>private Integer rankingNo;            //当前排名
private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private String level;                 //等级
private Integer vip;                  //是否是会员 1是 2不是
private Integer wealth;               //消费乐币数量
</code></pre>
<h3>7.8、房间广场-热门房间</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/room/common/hot_list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/room/common/hot_list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>热门房间</td><td>rooms</td><td>否</td><td>List</td><td>&nbsp;</td><td>热门房间</td></tr></tbody>
</table></figure>
<h5>热门房间模型 Room</h5>
<pre><code>private Integer roomID;               //热度值
private String roomName;              //房间名称
private String roomIcon;              //房间图片
private Integer onlineNum;            //在线人数
</code></pre>
<h3>7.9、房间广场-在线好友</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/room/common/follow_online.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/room/common/follow_online.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>在线好友</td><td>users</td><td>否</td><td>List</td><td>&nbsp;</td><td>在线好友</td></tr></tbody>
</table></figure>
<h5>在线好友模型 User</h5>
<pre><code>private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private Integer roomID;               //房间ID
private String roomName;              //房间名称
private Integer onlineNum;            //在线人数
private Integer isNeedPassword;        //是否上锁 1是 0 否
</code></pre>
<h3>7.10、分享房间</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/room/common/shareRoom.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/room/common/shareRoom.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>房间ID</td><td>roomID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>房间ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>在线好友</td><td>users</td><td>否</td><td>List</td><td>&nbsp;</td><td>在线好友</td></tr></tbody>
</table></figure>
<h3>7.21、全国榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/country.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/country.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>type</td><td>否</td><td>Short</td><td>&nbsp;</td><td>榜单类型 1、今日（默认） 2、昨天</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.22、地区榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/region.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/region.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>地区Id</td><td>regionId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>地区类型(传地区列表中的id)</td></tr><tr><td>类型</td><td>type</td><td>否</td><td>Short</td><td>&nbsp;</td><td>榜单类型 1、今日（默认） 2、昨天</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.23、新人榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/newbie.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/newbie.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.24、地区列表</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/regionList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/regionList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>地区列表</td><td>regionList</td><td>否</td><td>List</td><td>&nbsp;</td><td>地区列表</td></tr></tbody>
</table></figure>
<h5>地区列表模型 Region</h5>
<pre><code>private Integer regionId;        //地区Id
private String regionName;       //地区名称
private int hot;                 //火标识 1是 0否
</code></pre>
<h3>7.25、上榜记录</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/userRecordList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/userRecordList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>查询偏移标识</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>上一页查询最后一条记录的avId</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>上榜记录</td><td>recordList</td><td>否</td><td>List</td><td>&nbsp;</td><td>上榜记录</td></tr></tbody>
</table></figure>
<h5>用户上榜记录模型 UserBillboardRecord</h5>
<pre><code>private Long avId;             //作品Id
private String name;           //作品名称
private String cover;          //作品封面
private Date createTime;       //作品创建时间

private int countryPos;        //全国榜最高名次 1-99 0表示没过上榜

private int regionPos;         //地区榜最高名次 1-99 0表示没过上榜

private int newbiePos;         //新人榜最高名次 1-99 0表示没过上榜

private int songDayPos;        //单曲人气榜日榜最高名次 1-99 0表示没过上榜

private int songWeekPos;       //单曲人气榜周榜最高名次 1-99 0表示没过上榜

private int songMonthPos;      //单曲人气榜月榜最高名次 1-99 0表示没过上榜

private int songTotalPos;       //单曲人气总榜实时名次 1-99 0表示没上榜

private int songRegionPos;      //单曲地区榜最高名次 1-99 0表示没过上榜

private Integer regionId;       //地区Id 1-36
private String regionName;      //地区名称
</code></pre>
<h3>7.26、作品页上榜记录</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/workRecord.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/workRecord.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品Id</td><td>avId</td><td>否</td><td>Long</td><td>15</td><td>作品Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品上榜记录</td><td>record</td><td>否</td><td>WorkBillboardRecord</td><td>&nbsp;</td><td>作品上榜记录</td></tr></tbody>
</table></figure>
<h5>作品上榜记录模型 WorkBillboardRecord</h5>
<pre><code>private int countryPos;        //全国榜最高名次 1-99 0表示没过上榜

private int regionPos;         //地区榜最高名次 1-99 0表示没过上榜

private int newbiePos;         //新人榜最高名次 1-99 0表示没过上榜

private int songDayPos;        //单曲人气榜日榜最高名次 1-99 0表示没过上榜

private int songWeekPos;       //单曲人气榜周榜最高名次 1-99 0表示没过上榜

private int songMonthPos;      //单曲人气榜月榜最高名次 1-99 0表示没过上榜

private int songTotalPos;       //单曲人气总榜实时名次 1-99 0表示没上榜

private int songRegionPos;      //单曲地区榜最高名次 1-99 0表示没过上榜

private Integer regionId;       //地区Id 1-36
private String regionName;      //地区名称
</code></pre>
<h3>7.27、根据经纬度查地区Id</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/locateRegionId.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/locateRegionId.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>坐标经度</td><td>gpsY</td><td>否</td><td>String</td><td>坐标经度</td><td>&nbsp;</td></tr><tr><td>坐标纬度</td><td>gpsX</td><td>否</td><td>String</td><td>坐标纬度</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>地区Id</td><td>regionId</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>地区Id</td></tr><tr><td>地区名称</td><td>regionName</td><td>否</td><td>String</td><td>&nbsp;</td><td>地区名称</td></tr></tbody>
</table></figure>
<h3>7.31、人气日榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/song/popularDay.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/song/popularDay.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>歌曲Id</td><td>songId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>歌曲Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr><tr><td>我的成绩</td><td>myPos</td><td>否</td><td>int</td><td>&nbsp;</td><td>我的成绩，-1表示未发表该歌曲的作品，0表示未上榜 1-99表示名次</td></tr><tr><td>作品id</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>myPos为0时，返回用户榜单排名最靠前的作品id</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.32、人气周榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/song/popularWeek.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/song/popularWeek.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>歌曲Id</td><td>songId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>歌曲Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr><tr><td>我的成绩</td><td>myPos</td><td>否</td><td>int</td><td>&nbsp;</td><td>我的成绩，-1表示未发表该歌曲的作品，0表示未上榜 1-99表示名次</td></tr><tr><td>作品id</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>myPos为0时，返回用户榜单排名最靠前的作品id</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.33、人气月榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/song/popularMonth.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/song/popularMonth.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>歌曲Id</td><td>songId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>歌曲Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr><tr><td>我的成绩</td><td>myPos</td><td>否</td><td>int</td><td>&nbsp;</td><td>我的成绩，-1表示未发表该歌曲的作品，0表示未上榜 1-99表示名次</td></tr><tr><td>作品id</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>myPos为0时，返回用户榜单排名最靠前的作品id</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.34、人气总榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/song/popularTotal.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/song/popularTotal.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>歌曲Id</td><td>songId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>歌曲Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr><tr><td>我的成绩</td><td>myPos</td><td>否</td><td>int</td><td>&nbsp;</td><td>我的成绩，-1表示未发表该歌曲的作品，0表示未上榜 1-99表示名次</td></tr><tr><td>作品id</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>myPos为0时，返回用户榜单排名最靠前的作品id</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>7.35、人气地区榜</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/song/popularRegion.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/song/popularRegion.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>歌曲Id</td><td>songId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>歌曲Id</td></tr><tr><td>地区Id</td><td>regionId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>地区Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>作品列表</td><td>workList</td><td>否</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr><tr><td>我的成绩</td><td>myPos</td><td>否</td><td>int</td><td>&nbsp;</td><td>我的成绩，-1表示未发表该歌曲的作品，0表示未上榜 1-99表示名次</td></tr><tr><td>作品id</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>myPos为0时，返回用户榜单排名最靠前的作品id</td></tr></tbody>
</table></figure>
<h3>7.36、上榜记录新（新增隐藏功能）</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/userRecordListNew.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/userRecordListNew.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>查询偏移标识</td><td>avId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>上一页查询最后一条记录的avId</td></tr><tr><td>用户id</td><td>visitedUserId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>查看他人空间时加此参数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>上榜数量</td><td>billboardCount</td><td>Integer</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>上榜记录</td><td>recordList</td><td>否</td><td>List</td><td>&nbsp;</td><td>上榜记录</td></tr></tbody>
</table></figure>
<h5>用户上榜记录模型 UserBillboardRecord</h5>
<pre><code>private Long avId;             //作品Id
private String name;           //作品名称
private String cover;          //作品封面
private Date createTime;       //作品创建时间

private int countryPos;        //全国榜最高名次 1-99 0表示没过上榜

private int regionPos;         //地区榜最高名次 1-99 0表示没过上榜

private int newbiePos;         //新人榜最高名次 1-99 0表示没过上榜

private int songDayPos;        //单曲人气榜日榜最高名次 1-99 0表示没过上榜

private int songWeekPos;       //单曲人气榜周榜最高名次 1-99 0表示没过上榜

private int songMonthPos;      //单曲人气榜月榜最高名次 1-99 0表示没过上榜

private int songTotalPos;       //单曲人气总榜实时名次 1-99 0表示没上榜

private int songRegionPos;      //单曲地区榜最高名次 1-99 0表示没过上榜

private Integer regionId;       //地区Id 1-36
private String regionName;      //地区名称
private Short status;   //作品状态
private Short privateUpload; //是否私密状态

private Short isHide; //是否隐藏 0显示 1隐藏
</code></pre>
<h3>7.37、上榜记录列表作品隐藏显示 (鉴权)</h3>
<h5>接口作者：童健</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/billboard/work/userRecordHide.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/billboard/work/userRecordHide.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品id</td><td>avId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>状态</td><td>isHide</td><td>是</td><td>short</td><td>&nbsp;</td><td>0显示 1隐藏</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>&nbsp;</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h5>榜单模型 SpaceAvRankNew</h5>
<p><a href='#jumpSpaceAvRankNew'>跳转</a></p>
<h3>8.1、查询推荐关注用户列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/recommend/recommendAttentions.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/recommend/recommendAttentions.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>在线好友</td><td>users</td><td>否</td><td>List</td><td>&nbsp;</td><td>推荐关注用户</td></tr></tbody>
</table></figure>
<h5>推荐关注用户模型 RecommendAttention</h5>
<pre><code>private Long userID;             //用户ID
private String nickName;         //用户昵称
private String photo;            //用户头像
private Long levelSinger;        //用户歌手等级
private String imgUrl;           //等级图片(横)
</code></pre>
<h3>8.2、红人接口</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/redperson/list.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/redperson/list.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>红人类型</td><td>type</td><td>是</td><td>Short</td><td>&nbsp;</td><td>红人类型 1唱将  2达人 3新秀</td></tr><tr><td>页数</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>页数</td></tr><tr><td>每页数量</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页数量</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>红人列表</td><td>users</td><td>否</td><td>List</td><td>&nbsp;</td><td>红人列表</td></tr></tbody>
</table></figure>
<h5>红人模型 RedPerson</h5>
<pre><code>private Long userID;                  //用户ID
private String nickName;              //用户昵称
private String photo;                 //用户头像
private short memberShip;             //会员 1是 0不是
private short authType;               //-1未认证 0普通会员 1明星 2音乐人
private String authInfo;              //认证信息
private String description;           //简介
private Integer singerLevel;          //歌手等级
private String  levelName;            //等级称谓
private String  imgUrl;               //等级图片
</code></pre>
<h2>9、家族相关接口</h2>
<h3>9.1、热门家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/square/queryFamilies.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/square/queryFamilies.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>families</td><td>是</td><td>List</td><td>&nbsp;</td><td>家族列表</td></tr></tbody>
</table></figure>
<h5>家族排行模型 FamilyRank</h5>
<pre><code>private Long familyID;      //家族ID
private Long memberNum;     //成员数
private Long workNum;       //作品数
private String name;        //家族名称
private String tag1;        //家族标签1
private String tag2;        //家族标签2
private String photo;       //家族头像
private Short state;        //家族状态
private Long leader;        //家族长
private Long score;         //家族积分
private Long level;         //家族等级
private Integer imgType;    //家族图片显示类型 1亮 0暗
private Long rank;          //全服排名
private Short authAdvancedState;//家族高级认证状态 0未认证 1已认证
private Short authState;//家族普通认证状态 0未认证 1已认证
private String authStateLevel;//家族普通和高级认证的图标配置的key
key对应配置接口里的allIcons的key(https://music.51vv.com/user/cfg/getCfgInfo.htm)

</code></pre>
<h3>9.2、查询我的家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/square/queryMyFamily.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/square/queryMyFamily.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族信息</td><td>family</td><td>是</td><td>FamilyRank</td><td>&nbsp;</td><td>家族信息</td></tr></tbody>
</table></figure>
<h5>家族排行模型 FamilyRank</h5>
<pre><code>private Long familyID;      //家族ID
private Long memberNum;     //成员数
private Long workNum;       //作品数
private String name;        //家族名称
private String tag1;        //家族标签1
private String tag2;        //家族标签2
private String photo;       //家族头像
private Short state;        //家族状态 0待审 1审核处理中 2审核通过 3审核不通过 4冻结 5解散 6关闭 7撤销申请
private Long leader;        //家族长
private Long score;         //家族积分
private Long level;         //家族等级
private Integer imgType;    //家族图片显示类型 1亮 0暗
private Long rank;          //全服排名
private Long hotRank;       //热门排名 可空（2018年5月3日新增）
private Long hotPopularity; //7天内发表的作品人气值 可空（2018年5月3日新增）
private Short authAdvancedState;//家族高级认证状态 0未认证 1已认证
private Short authState;//家族普通认证状态 0未认证 1已认证
private String authStateLevel;//家族普通和高级认证的图标配置的key
key对应配置接口里的allIcons的key(https://music.51vv.com/user/cfg/getCfgInfo.htm)
</code></pre>
<h3>9.3、检查创建家族资格</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/checkCreateQualify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/checkCreateQualify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1歌手等级不到15或者不是会员 -2已加入家族 -3创建家族申请中 -4家族申请中 -5退出不到24小时</td></tr><tr><td>家族名称</td><td>familyName</td><td>否</td><td>String</td><td>&nbsp;</td><td>家族名称 当result=-2、-3、-4的时候返回</td></tr><tr><td>弹窗提示</td><td>alert</td><td>否</td><td>String</td><td>&nbsp;</td><td>弹窗提示 当result=-1的时候返回</td></tr></tbody>
</table></figure>
<h3>9.4、创建家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/create.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/create.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族名称</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>家族名称</td></tr><tr><td>家族公告</td><td>notice</td><td>是</td><td>String</td><td>&nbsp;</td><td>家族公告</td></tr><tr><td>家族标签1</td><td>tag1</td><td>是</td><td>String</td><td>&nbsp;</td><td>家族标签1</td></tr><tr><td>家族标签2</td><td>tag2</td><td>是</td><td>String</td><td>&nbsp;</td><td>家族标签2</td></tr><tr><td>家族头像</td><td>photo</td><td>是</td><td>String</td><td>&nbsp;</td><td>家族头像</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表 1088家族重名</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.5、修改家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/update.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/update.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>家族名称</td><td>name</td><td>否</td><td>String</td><td>&nbsp;</td><td>家族名称</td></tr><tr><td>家族公告</td><td>notice</td><td>否</td><td>String</td><td>&nbsp;</td><td>家族公告</td></tr><tr><td>家族标签1</td><td>tag1</td><td>否</td><td>String</td><td>&nbsp;</td><td>家族标签1</td></tr><tr><td>家族标签2</td><td>tag2</td><td>否</td><td>String</td><td>&nbsp;</td><td>家族标签2</td></tr><tr><td>家族头像</td><td>photo</td><td>是</td><td>String</td><td>&nbsp;</td><td>家族头像</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.6、查询家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/query.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>否</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族信息</td><td>family</td><td>是</td><td>Family</td><td>&nbsp;</td><td>家族信息</td></tr><tr><td>签到状况</td><td>sign</td><td>是</td><td>int</td><td>&nbsp;</td><td>签到状况  1已签到 0未签到</td></tr><tr><td>是否展示活动申请链接</td><td>activityFlag</td><td>是</td><td>Boolean</td><td>&nbsp;</td><td>申请链接  true:展示 false:不展示</td></tr></tbody>
</table></figure>
<h5>家族模型 Family</h5>
<pre><code>private Long familyID;      //家族ID
private String name;        //家族名称
private String notice;      //家族公告
private String tag1;        //家族标签1
private String tag2;        //家族标签2
private String photo;       //家族头像
private Long leader;        //家族长用户ID
private Integer roomID;     //家族房间ID
private Short roomState;    //家族房间状态 0未开通 1开通 2关闭
private Short state;        //家族状态 0待审 1审核处理中 2审核通过 3审核不通过 4冻结 5解散 6关闭
private Long score;         //家族积分
private Long level;         //家族等级
private Integer imgType;    //家族图片显示类型 1亮 0暗
private Integer memberNum;  //家族人数
private Integer workNum;    //家族作品数
private Integer rank;       //家族排名
private Long popularity;    //家族人气值
private String roomName;    //房间名称
private String roomCover;   //房间图片
private Long onlineNum;     //房间在线人数
private Long hotRank;       //热门排名 可空（2018年5月3日新增）
private Long hotPopularity; //7天内发表的作品人气值 可空（2018年5月3日新增）
private Integer articleNum; // 家族动态文章数 (2019-11-20张磊新增)

private String newRoomName;	//新家族歌房名称，若没有开通过新家族歌房，默认&quot;&quot;
private String newOnlineNum;//新家族歌房，在线人数，若没有开通过新家族歌房，默认&quot;&quot;
private String newRoomStatus;//新家族歌房，房间状态，0 关闭（解散），1 开启。若没有开通过新家族歌房，默认&quot;&quot; 
private String newRoomManageStatus;	//新家族歌房房间管理状态，0开通歌房后的默认值，4关停。
private String newRoomCover;//新家族歌房图片，若没有开通过新家族歌房，默认&quot;&quot; 
private Integer hasNewRoom;//是否有新歌房,0没有，1有
private Long newRoomID;		//新歌房roomID
private Short authAdvancedState;//家族高级认证状态 0未认证 1已认证
private Short authState;//家族普通认证状态 0未认证 1已认证
private String authStateLevel;//家族普通和高级认证的图标配置的key
key对应配置接口里的allIcons的key(https://music.51vv.com/user/cfg/getCfgInfo.htm)
</code></pre>
<h3>9.7、检查解散家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/checkDismissQualify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/checkDismissQualify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1无权限, -2人数超过10人,-3之前的申请正在等待审核中，重复申请了</td></tr></tbody>
</table></figure>
<h3>9.8、解散家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/dismiss.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/dismiss.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1无权限 -2人数超过10人, -3之前的申请正在等待审核中，重复申请了</td></tr></tbody>
</table></figure>
<h3>9.9、推荐标签</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/recommendTags.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/recommendTags.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>type</td><td>int</td><td>是</td><td>int</td><td>&nbsp;</td><td>类型 1家族标签 2成员标签</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>推荐标签</td><td>tags</td><td>否</td><td>List</td><td>&nbsp;</td><td>推荐标签</td></tr></tbody>
</table></figure>
<h3>9.10、家族动态</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/work/queryMoments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/work/queryMoments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>作品列表</td><td>works</td><td>是</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr></tbody>
</table></figure>
<h5>家族作品模型 FamilyWork</h5>
<pre><code>private Long AVID;           //作品ID
private String name;         //作品名称
private String fileUrl;      //作品地址
private Integer fileType;    //作品类型 4是视频 其他是音频
private String description;  //作品描述
private Long userID;         //用户ID
private String nickName;     //昵称
private String photo;        //头像
private Integer isVip;       //是否会员 1是 0不是
private Date createTime;     //发布时间
private Integer playTimes;   //播放次数
private Integer praiseTimes; //点赞次数
private Long giftAmount;     //礼物数
private Integer commentTimes;//评论数
private Integer shareTimes;  //分享数
private Integer priority;    //优先级 默认1000，小于1000是置顶
private Long hot;            //热度值
private String createTimeByFormat //格式化后的时间
private Integer authType;    //认证类型 -1非 0普通 1明星 2音乐人
private Integer exFileType;  //扩展类型 0独唱 1合唱 2发起合唱
private String tag;          //家族成员标签
private Integer chorusNum;   //合唱次数
private Long flowerAmount;   //鲜花数
</code></pre>
<h3>9.11、家族作品查询</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/work/queryWorks.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/work/queryWorks.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>&nbsp;</td><td>类型 1置顶列表 2最近24小时列表 3七天最热列表</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>作品列表</td><td>works</td><td>是</td><td>List</td><td>&nbsp;</td><td>作品列表</td></tr></tbody>
</table></figure>
<h5>家族作品模型 FamilyWork</h5>
<pre><code>private Long AVID;           //作品ID
private String name;         //作品名称
private String fileUrl;      //作品地址
private Integer fileType;    //作品类型 4是视频 其他是音频
private String description;  //作品描述
private Long userID;         //用户ID
private String nickName;     //昵称
private String photo;        //头像
private Integer isVip;       //是否会员 1是 0不是
private Date createTime;     //发布时间
private Integer playTimes;   //播放次数
private Integer praiseTimes; //点赞次数
private Long giftAmount;     //礼物数
private Integer commentTimes;//评论数
private Integer shareTimes;  //分享数
private Integer priority;    //优先级 默认1000，小于1000是置顶
private Long hot;            //热度值
private String createTimeByFormat //格式化后的时间
private Integer authType;    //认证类型 -1非 0普通 1明星 2音乐人
private Integer exFileType;  //扩展类型 0独唱 1合唱 2发起合唱
private String tag;          //家族成员标签
private Integer chorusNum;   //合唱次数
private Long flowerAmount;   //鲜花数
</code></pre>
<h3>9.12、置顶作品</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/work/stick.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/work/stick.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>作品ID</td><td>AVID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>类型</td><td>operType</td><td>是</td><td>int</td><td>&nbsp;</td><td>类型 1置顶 2取消置顶</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1置顶作品超过3个</td></tr></tbody>
</table></figure>
<h3>9.13、检查申请加入家族资格</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/checkApplyQualify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/checkApplyQualify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1已加入家族 -2创建家族申请中 -3家族申请中 -4退出不到24小时 -5已创建家族</td></tr></tbody>
</table></figure>
<h3>9.14、申请加入家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/apply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/apply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.15、审核加入申请</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/audit.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/audit.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>待审核用户IDs</td><td>auditUserIDs</td><td>是</td><td>String</td><td>20002,20005</td><td>待审核用户IDs,用英文逗号隔开</td></tr><tr><td>操作类型</td><td>operType</td><td>是</td><td>Short</td><td>&nbsp;</td><td>操作类型 1通过 2不通过</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.16、退出家族</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/quit.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/quit.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.17、管理成员</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/manage.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/manage.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>成员用户IDs</td><td>memberUserIDs</td><td>是</td><td>String</td><td>20002,20005</td><td>成员用户IDs,用英文逗号隔开</td></tr><tr><td>类型</td><td>operType</td><td>是</td><td>int</td><td>&nbsp;</td><td>类型 1踢出 2加管 3消管</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1无权限 -2管理员超过上限 -3今日踢出超过10人</td></tr></tbody>
</table></figure>
<h3>9.18、查询成员</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/queryMember.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/queryMember.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>成员用户ID</td><td>memberUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>成员用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族成员信息</td><td>member</td><td>是</td><td>FamilyMember</td><td>&nbsp;</td><td>家族成员信息</td></tr><tr><td>是否正在申请中</td><td>isAppling</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否正在申请中 1是 0否</td></tr></tbody>
</table></figure>
<h5>家族成员模型 FamilyMember</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer userType;         //用户类型 1成员 2管理 3家族长
private String tag;               //成员标签
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
</code></pre>
<h3>9.19、设置成员标签</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/setMemberTag.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/setMemberTag.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>成员用户ID</td><td>memberUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>成员用户ID</td></tr><tr><td>标签</td><td>tag</td><td>是</td><td>String</td><td>&nbsp;</td><td>标签</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1管理员无权修改家族长标签</td></tr></tbody>
</table></figure>
<h3>9.20、查询成员列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/queryMembers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/queryMembers.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>成员列表</td><td>members</td><td>是</td><td>List</td><td>&nbsp;</td><td>成员列表</td></tr><tr><td>正在申请的数量</td><td>applingNum</td><td>是</td><td>int</td><td>&nbsp;</td><td>正在申请的数量</td></tr></tbody>
</table></figure>
<h5>家族成员模型 FamilyMember</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer userType;         //用户类型 1成员 2管理 3家族长 4副家族长 5家族主播
private String tag;               //成员标签
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
</code></pre>
<h3>9.21、家族土豪榜</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/billboard/moneyRank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/billboard/moneyRank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>用户列表</td><td>users</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr></tbody>
</table></figure>
<h5>家族排行榜用户模型 FamilyBillboardUser</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
private Long moneyLevel;          //财富等级
private String moneyLevelImgUrl;  //财富等级图片
private Long num;                 //数值
private Integer rank;             //排名
</code></pre>
<h3>9.22、家族人气榜</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/billboard/popularRank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/billboard/popularRank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>用户列表</td><td>users</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr></tbody>
</table></figure>
<h5>家族排行榜用户模型 FamilyBillboardUser</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
private Long moneyLevel;          //财富等级
private String moneyLevelImgUrl;  //财富等级图片
private Long num;                 //数值
private Integer rank;             //排名
</code></pre>
<h3>9.23、家族麦霸榜</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/billboard/singRank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/billboard/singRank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>用户列表</td><td>users</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户列表</td></tr></tbody>
</table></figure>
<h5>家族排行榜用户模型 FamilyBillboardUser</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
private Long moneyLevel;          //财富等级
private String moneyLevelImgUrl;  //财富等级图片
private Long num;                 //数值
private Integer rank;             //排名
</code></pre>
<h3>9.24、查询帐户</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/account/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/account/query.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族帐户信息</td><td>familyAccount</td><td>是</td><td>FamilyAccount</td><td>&nbsp;</td><td>家族帐户信息</td></tr><tr><td>家族状态</td><td>familyState</td><td>是</td><td>Short</td><td>&nbsp;</td><td>家族状态 0待审 1审核处理中 2审核通过 3审核不通过 4冻结 5解散 6关闭 7撤销申请</td></tr></tbody>
</table></figure>
<h5>家族帐户信息 FamilyAccount</h5>
<pre><code>private Long diamond;      //乐币数
private Long flower;       //鲜花数

</code></pre>
<h3>9.25、分配乐币和鲜花</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/account/allocate.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/account/allocate.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>分配用户IDs</td><td>userIDs</td><td>是</td><td>String</td><td>20002,20005</td><td>分配用户IDs,如果有多个，用英文逗号隔开</td></tr><tr><td>每人要分配的乐币数</td><td>diamond</td><td>是</td><td>Long</td><td>&nbsp;</td><td>每人要分配的乐币数</td></tr><tr><td>每人要分配的鲜花数</td><td>flower</td><td>是</td><td>Long</td><td>&nbsp;</td><td>每人要分配的鲜花数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1无权限 -2余额不足 -3部分失败</td></tr></tbody>
</table></figure>
<h3>9.26、查询家族房间</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/room/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/room/query.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族房间信息</td><td>familyRoom</td><td>是</td><td>FamilyRoom</td><td>&nbsp;</td><td>家族信息</td></tr></tbody>
</table></figure>
<h5>家族房间信息 FamilyRoom</h5>
<pre><code>private Integer roomID;     //家族房间ID
private Short roomState;    //家族房间状态  0未开通 1开通 2关闭
private String roomName;    //房间名称
private String roomCover;   //房间图片
private Long onlineNum;     //房间在线人数
</code></pre>
<h3>9.27、检查家族房间开通资格</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/room/checkQualify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/room/checkQualify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1无权限 -2已开通 -3人数不符合要求</td></tr></tbody>
</table></figure>
<h3>9.28、家族签到</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/sign/sign.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/sign/sign.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败 -1已签到</td></tr></tbody>
</table></figure>
<h3>9.29、查询统计</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/stat/queryStat.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/stat/queryStat.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族统计信息</td><td>familyStat</td><td>是</td><td>FamilyStat</td><td>&nbsp;</td><td>家族统计信息</td></tr></tbody>
</table></figure>
<h5>家族统计模型 FamilyStat</h5>
<pre><code>private Long newMemberNum;          //今日新增数
private Long signNum;               //今日签到数
private Long quitNum;               //今日退出数
private Long workNum;               //今日作品数
private Long roomPeakNum;           //昨天房间峰值人数
private Long roomAverageNum;        //昨天房间平均人数
private Long roomConsumeDiamond;    //昨日房间消费
private Long roomOnlineTime;        //昨日房间在线时长（分钟）
</code></pre>
<h3>9.30、查询统计明细</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/stat/queryStatDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/stat/queryStatDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>&nbsp;</td><td>类型 1每日新增 2每日签到 3每日退出 4每日作品数 5每日房间峰值人数 6每日房间平均人数 7每日房间消费 8每日在线时长</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>近30天总数</td><td>recentNum</td><td>是</td><td>Long</td><td>&nbsp;</td><td>近30天总数</td></tr><tr><td>金话筒认证人数</td><td>goldVoiceCount</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>金话筒认证人数</td></tr><tr><td>紫v用户人数</td><td>purpleCount</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>紫v用户人数</td></tr><tr><td>有效拉新人数</td><td>pullNewCount</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>有效拉新人数</td></tr><tr><td>家族统计明细</td><td>details</td><td>是</td><td>List</td><td>&nbsp;</td><td>家族统计明细</td></tr></tbody>
</table></figure>
<h5>家族统计明细模型 FamilyStatDetail</h5>
<pre><code>private Date date;            //日期
private Long num;             //数量
private String dateByFormat;  //格式化后的日期
</code></pre>
<h3>9.31、查询待审核成员</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/queryApplyMembers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/queryApplyMembers.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族成员申请列表</td><td>applies</td><td>是</td><td>List</td><td>&nbsp;</td><td>家族成员申请列表</td></tr></tbody>
</table></figure>
<h5>家族成员申请模型 FamilyMemberApply</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
private Long moneyLevel;          //财富等级
private String moneyLevelImgUrl;  //财富等级图片
private Long level;               //活跃等级
private String levelImgUrl;       //活跃等级图片
</code></pre>
<h3>9.32、撤销家族创建申请</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/cancelCreateQualify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/cancelCreateQualify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.33、撤销加入家族申请</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/cancelApplyQualify.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/cancelApplyQualify.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>操作结果</td><td>result</td><td>否</td><td>int</td><td>&nbsp;</td><td>操作结果 1成功 0失败</td></tr></tbody>
</table></figure>
<h3>9.34、帐户收入明细</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/account/incomeDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/account/incomeDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>收入明细</td><td>accountLogs</td><td>是</td><td>List</td><td>&nbsp;</td><td>收入明细</td></tr></tbody>
</table></figure>
<h5>家族收入支出明细模型 FamilyAccountLog</h5>
<pre><code>private String remark;     //备注
private Date createTime;   //时间
private Long diamond;      //钻石
private Long flower;       //鲜花
private String createTimeByFormat;  //格式化后的日期
</code></pre>
<h3>9.35、帐户支出明细</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/account/spendDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/account/spendDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>支出明细</td><td>accountLogs</td><td>是</td><td>List</td><td>&nbsp;</td><td>支出明细</td></tr></tbody>
</table></figure>
<h5>家族收入支出明细模型 FamilyAccountLog</h5>
<pre><code>private String remark;     //备注
private Date createTime;   //时间
private Long diamond;      //钻石
private Long flower;       //鲜花
private String createTimeByFormat;  //格式化后的日期
</code></pre>
<h3>9.36、家族经验等级</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/queryLevelDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/queryLevelDetail.htm</a></p>
<h5>请求方式</h5>
<p>post方式</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>String</td><td>&#39;0&#39;</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>参数格式错误</td><td>错误提示信息</td></tr><tr><td>家族等级详情</td><td>levelDetail</td><td>否</td><td>FamilyLevelDetail</td><td>&nbsp;</td><td>家族等级详情</td></tr></tbody>
</table></figure>
<h5>家族等级详情模型 FamilyLevelDetail</h5>
<pre><code>private Long familyID;                //用户ID
private Integer level;                //家族等级
private Integer exp;                  //家族经验
private Integer currentLevelExp;      //当前等级经验
private Integer prevLevel;            //上一等级
private Integer prevLevelExp;         //上一等级级经验
private String  levelName;            //等级称谓
private String  imgUrl;               //等级图片
private Integer adminLimit;           //管理员人数上限
private Integer memberLimit;          //会员人数上限
</code></pre>
<h3>9.37、新查询成员列表</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findFamilyMembers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findFamilyMembers.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr><tr><td>昵称</td><td>nickName</td><td>否</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>成员列表</td><td>members</td><td>是</td><td>List</td><td>&nbsp;</td><td>成员列表</td></tr><tr><td>正在申请的数量</td><td>applingNum</td><td>是</td><td>int</td><td>&nbsp;</td><td>正在申请的数量</td></tr></tbody>
</table></figure>
<h5>家族成员模型 FamilyMember</h5>
<pre><code>private Long userID;              //用户ID
private String nickName;          //用户昵称
private String photo;             //用户头像
private Integer userType;         //用户类型 1成员 2管理 3家族长 4 副家族长 5家族主播
private String tag;               //成员标签
private Integer isVip;            //是否会员
private Long singerLevel;         //歌手等级
private String singerLevelImgUrl; //歌手等级图片
</code></pre>
<h3>9.38、家族总榜</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/square/queryTopFamilies.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/square/queryTopFamilies.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>families</td><td>是</td><td>List</td><td>&nbsp;</td><td>家族列表</td></tr></tbody>
</table></figure>
<h5>家族排行模型 FamilyRank</h5>
<pre><code>private Long familyID;      //家族ID
private Long memberNum;     //成员数
private Long workNum;       //作品数
private String name;        //家族名称
private String tag1;        //家族标签1
private String tag2;        //家族标签2
private String photo;       //家族头像
private Short state;        //家族状态
private Long leader;        //家族长
private Long score;         //家族积分
private Long level;         //家族等级
private Integer imgType;    //家族图片显示类型 1亮 0暗
private Long rank;          //全服排名
private Short authAdvancedState;//家族高级认证状态 0未认证 1已认证
private Short authState;//家族普通认证状态 0未认证 1已认证
private String authStateLevel;//家族普通和高级认证的图标配置的key
key对应配置接口里的allIcons的key(https://music.51vv.com/user/cfg/getCfgInfo.htm)
</code></pre>
<h3>9.39、验证设置副家族长</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/validSetAssisantFamilyLeader.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/validSetAssisantFamilyLeader.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>副家族长剩余数量</td><td>count</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功  2家族不存在 3// 操作人非家族长 4家族等级配置不存在 5副家族长人数已到上限 6非家族成员 7成员是家族主唱 8成员是管理员 9成员已是副家族长
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.40、设置副家族长</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/setAssistantFamilyLeader.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/setAssistantFamilyLeader.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功  2家族不存在 3// 操作人非家族长 4家族等级配置不存在 5副家族长人数已到上限 6非家族成员 7成员是家族主唱 8成员是管理员 9成员已是副家族长
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.41、取消副家族长</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/cancelAssistantFamilyLeader.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/cancelAssistantFamilyLeader.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功  2家族不存在 3// 操作人非家族长 4家族等级配置不存在 5副家族长人数已到上限 6非家族成员 7成员是家族主唱 8成员是管理员 9成员已是副家族长
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.42、验证是否有家族主播资格</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/validSetFamilyAnchor.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/validSetFamilyAnchor.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功 2家族不存在 3家族等级不存在 4家族主唱名额不足 5家族管理人员不能被邀请成为家族主唱 6正在邀请中，请等待通知 7家族长与当前设置人不匹配
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.43、取消家族主播</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/cancelFamilyAnchor.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/cancelFamilyAnchor.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功 2家族不存在 3操作人非家族长
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.44、设置家族主播</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/setFamilyAnchor.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/setFamilyAnchor.htm</a>
示例：<a href='https://music.51vv.com/sodnew/family/member/setFamilyAnchor.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/setFamilyAnchor.htm?parameter=</a>{&quot;invitationID&quot;:324,&quot;status&quot;:2,&quot;anchorExpireLimit&quot;:60}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>邀请ID</td><td>invitationID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作状态</td><td>status</td><td>是</td><td>int</td><td>&nbsp;</td><td>1拒绝 2同意</td></tr><tr><td>设置签约时间</td><td>anchorExpireLimit</td><td>是</td><td>int</td><td>&nbsp;</td><td>同意 必填 从anchorExpireList取</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>状态</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>受邀请者昵称</td><td>nickName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>签约时间</td><td>anchorExpireLimit</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功 2邀请函不存在 3已拒绝 4已同意 5已超过72小时或超过10天,邀请已经失效 6非家族成员 7您已成为家族管理员，邀请函已失效 8您已成为副家族长，邀请函已失效 9您已成为家族主唱，邀请函已失效 10当前人无设置权限
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.45、邀请家族主播</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/inviteFamilyAnchor.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/inviteFamilyAnchor.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>主播退出时长限制,范围0-24</td><td>anchorExpireLimit</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>状态</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>邀请主键标识</td><td>invitationID</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功,2正在邀请中，请等待通知
            &quot;invitationID&quot;:1, // 
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.46、查询家族主播邀请函信息</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findAnchorInvitation.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findAnchorInvitation.htm</a>
示例：<a href='https://music.51vv.com/sodnew/family/member/findAnchorInvitation.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findAnchorInvitation.htm?parameter=</a>{&quot;invitationID&quot;:324}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>邀请函ID</td><td>invitationID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>状态</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>主唱签约时间</td><td>anchorExpireLimit</td><td>是</td><td>int</td><td>与anchorExpireList互斥</td><td>&nbsp;</td></tr><tr><td>主唱初始化签约时间</td><td>anchorExpireList</td><td>是</td><td>List</td><td>与anchorExpireLimit互斥</td><td>&nbsp;</td></tr><tr><td>家族名称</td><td>familyName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>受邀请者昵称</td><td>memberName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>邀请者昵称</td><td>operName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>截止时间</td><td>deadLine</td><td>是</td><td>String</td><td>&nbsp;</td><td>链接from=1显示</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功 2邀请函不存在 3已拒绝 4已同意 5已超过72小时或超过10天,邀请已经失效 6非家族成员 7您已成为家族管理员，邀请函已失效 8您已成为副家族长，邀请函已失效 9您已成为家族主唱，邀请函已失效 10只有被邀请者能查看此信息 11您已成为家族成员，邀请函已失效
            &quot;anchorExpireLimit&quot;:60 ，
			&quot;familyName&quot;:&quot;&quot;,
			&quot;memberName&quot;:&quot;&quot;,
			&quot;operName&quot;:&quot;&quot;,
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.47、验证是否有家族管理员资格</h3>
<h5>接口作者：吴迪</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/validSetFamilyAdmin.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/validSetFamilyAdmin.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>成员ID</td><td>memberUserID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1, // 1成功 2家族不存在 3非家族成员 4家族等级配置不存在 5管理员人数已达上限 6该成员是家族主唱 7该成员是副家族长 8当用户是主播或副家族长时,副家族长无权限操作
            &quot;count&quot;:1, // 剩余管理员数量
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.48、家族长申请家族歌房</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/room/applyFamilyRoom.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/room/applyFamilyRoom.htm?parameter=</a>{userID:,familyID:}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作人ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>state</td><td>否</td><td>int</td><td>0，1，2</td><td>申请的歌房状态</td></tr><tr><td>家族列表</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>能否申请</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>        {
            &quot;result&quot;:1,//1，申请成功；-1：申请失败，家族成员少于10人；-2：申请失败，已经申请过歌房。
            &quot;state&quot; :0, //0：审核中，1：审核通过，2：审核不通过
            &quot;retCode&quot;:1000
        }
</code></pre>
<h3>9.49、校验家族紫V用户同意或已过期的页面</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findPurpleInvitation.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findPurpleInvitation.htm?parameter=</a>{invitationID:111}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>邀请函ID</td><td>invitationID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>返回信息</td><td>msg</td><td>否</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>分别代表的意思如下：
{&quot;result&quot;:2,&quot;retCode&quot;:1000,&quot;msg&quot;:&quot;邀请信息不存在&quot;}

{&quot;result&quot;:4,&quot;retCode&quot;:1000,&quot;msg&quot;:&quot;用户已同意&quot;}

{&quot;result&quot;:5,&quot;retCode&quot;:1000,&quot;msg&quot;:&quot;邀请已经失效&quot;}

{&quot;result&quot;:6,&quot;retCode&quot;:1000,&quot;msg&quot;:&quot;非家族成员&quot;}

{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;msg&quot;:&quot;可以成为家族紫V认证用户&quot;}
</code></pre>
<h3>9.50、用户同意成为紫V认证用户</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/setFamilyPurple.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/setFamilyPurple.htm?parameter=</a>{invitationID:4,status:4}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>邀请函ID</td><td>invitationID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>status</td><td>status</td><td>是</td><td>short</td><td>&nbsp;</td><td>status必须是4，代表用户已同意</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>返回信息</td><td>msg</td><td>否</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>分别代表的意思如下：

{&quot;result&quot;:2,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;邀请信息不存在&quot;}

{&quot;result&quot;:3,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;邀请的用户不存在&quot;}

{&quot;result&quot;:5,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户已经是紫V认证&quot;}

{&quot;result&quot;:6,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户已经是紫V认证&quot;}

{&quot;result&quot;:7,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户已经是紫V认证&quot;}

{&quot;result&quot;:8,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;邀请已经失效&quot;}

{&quot;result&quot;:9,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;家族长不能成为紫V认证用户&quot;}

{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;成为紫V认证用户成功&quot;}

</code></pre>
<h3>9.51、家族长查看紫v申请列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findPurpleApplyList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findPurpleApplyList.htm?parameter=</a>{familyID:168}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>familyID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900008796,
		&quot;status&quot;: 4,//申请状态。0待处理 1重新申请2官方同意邀请中 3官方拒绝未通过 4用户同意已认证 5用户未接受&#39;,
		&quot;configSingerLevel&quot;: {
			&quot;endLevel&quot;: 11,
			&quot;femaleLevelName&quot;: &quot;驻唱歌手&quot;,
			&quot;imgUrl&quot;: &quot;singer-da-11@3x.png&quot;,
			&quot;imgUrl_heng&quot;: &quot;exsinger-heng-11.png&quot;,
			&quot;maleLevelName&quot;: &quot;驻唱歌手&quot;,
			&quot;startLevel&quot;: 11
		},
		&quot;nickName&quot;: &quot;往事如风&quot;,//昵称
		&quot;levelSinger&quot;: 11,//歌手等级
		&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/06/30/1806301637220d0f8c7b96534e78.jpg&quot;
	}, {
		&quot;userID&quot;: 900009929,
		&quot;status&quot;: 0,
		&quot;configSingerLevel&quot;: {
			&quot;endLevel&quot;: 13,
			&quot;femaleLevelName&quot;: &quot;驻唱歌手&quot;,
			&quot;imgUrl&quot;: &quot;singer-da-13@3x.png&quot;,
			&quot;imgUrl_heng&quot;: &quot;exsinger-heng-13.png&quot;,
			&quot;maleLevelName&quot;: &quot;驻唱歌手&quot;,
			&quot;startLevel&quot;: 13
		},
		&quot;nickName&quot;: &quot;大甜瓜&quot;,
		&quot;levelSinger&quot;: 13,
		&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/08/16/180816134731e9f4780b90a84771.jpg&quot;
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<h3>9.52 用户查看自己的紫V邀请函详情</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findMySelfPurpleInvitation.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findMySelfPurpleInvitation.htm?parameter=</a>{userID:168}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>userID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>{
	&quot;result&quot;: {
		&quot;ID&quot;: 4,
		&quot;createTime&quot;: 1537165795000,//创建时间
		&quot;familyID&quot;: 168,//家族ID
		&quot;operReson&quot;: &quot;&quot;,//审核原因
		&quot;operTime&quot;: 1537237565000,//审核时间
		&quot;operUserID&quot;: 0,//审核人ID
		&quot;status&quot;: 4,//审核状态
		&quot;userID&quot;: 900008796,
		&quot;videoLink&quot;: &quot;&quot;,//认证视频链接
		&quot;weChat&quot;: &quot;&quot;//微信号
	},
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>9.53 家族长开始申请紫V认证</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='http://music.51vv.com/sodnew/family/member/applyPurple.htm?parameter=' target='_blank' class='url'>http://music.51vv.com/sodnew/family/member/applyPurple.htm?parameter=</a>{familyID:,userID:}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>userID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>{&quot;result&quot;:2,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户不是家族成员，不能邀请成为紫V认证主播&quot;}

{&quot;result&quot;:3,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户未实名认证&quot;}

{&quot;result&quot;:4,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户已经是紫V认证用户&quot;}

{&quot;result&quot;:5,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户已有黄/红/懒认证，确定要紫V认证？&quot;}

{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户可以提交申请&quot;,&quot;nickName&quot;:&quot;&quot;,&quot;photo&quot;:&quot;&quot;}

</code></pre>
<h3>9.54 家族长提交紫V申请</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/submitPurple.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/submitPurple.htm?parameter=</a>{familyID:,userID:,weChat:,videoLink:}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>userID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>familyID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>weChat</td><td>weChat</td><td>是</td><td>String</td><td>&nbsp;</td><td>微信号</td></tr><tr><td>videoLink</td><td>videoLink</td><td>是</td><td>String</td><td>&nbsp;</td><td>认证视频链接</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>{&quot;result&quot;:2,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户不是家族成员，不能邀请成为紫V认证主播&quot;}

{&quot;result&quot;:3,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户未实名认证&quot;}

{&quot;result&quot;:4,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户已经是紫V认证用户&quot;}

{&quot;result&quot;:5,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;该用户已有黄/红/懒认证，确定要紫V认证？&quot;}

{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;申请紫V认证成功&quot;}

</code></pre>
<h3>9.55 用户去紫V续约页面</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/renewContractPurple.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/renewContractPurple.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>只有result为1的情况才可以展示同意页面。</td></tr></tbody>
</table></figure>
<h5>示例</h5>
<pre><code>{&quot;result&quot;:1,&quot;retCode&quot;:1000}//成功，正常显示

{&quot;result&quot;:2,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户紫V信息不存在&quot;}//用户已经拒绝续约紫V

{&quot;result&quot;:3,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;续约邀请函已失效&quot;}//用户同意续约紫V

{&quot;result&quot;:4,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;超过10天未处理，已默认接受续约邀请&quot;}//系统强制给用户续约紫V

</code></pre>
<h3>9.56 是否显示紫V续约提示</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/isShowPurple.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/isShowPurple.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>isShow</td><td>是</td><td>int</td><td>&nbsp;</td><td>1显示，0不显示</td></tr><tr><td>返回结果</td><td>noticeTime</td><td>是</td><td>Date</td><td>2019-04-25 09:00:00</td><td>开始通知的时间</td></tr><tr><td>返回结果</td><td>pastDueTime</td><td>是</td><td>Date</td><td>2019-04-25 09:00:00</td><td>过期时间</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;leaderID&quot;:1,&quot;nickName&quot;:}//更新成功


{&quot;result&quot;:3,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户紫V信息不存在&quot;}
</code></pre>
<h3>9.57 紫V用户续约或取消续约</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/updateAuthFamily.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/updateAuthFamily.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>type</td><td>是否续约</td><td>是</td><td>short</td><td>1</td><td>是否续约：1用户拒绝紫V续约 0用户同意续约紫V</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>isShow</td><td>是</td><td>int</td><td>&nbsp;</td><td>1显示，0不显示</td></tr><tr><td>返回结果</td><td>noticeTime</td><td>是</td><td>Date</td><td>2019-04-25 09:00:00</td><td>开始通知的时间</td></tr><tr><td>返回结果</td><td>pastDueTime</td><td>是</td><td>Date</td><td>2019-04-25 09:00:00</td><td>过期时间</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;isShow&quot;:1,&quot;noticeTime&quot;:,&quot;pastDueTime&quot;:}//成功

{&quot;result&quot;:2,&quot;retCode&quot;:1000,&quot;retMsg&quot;:&quot;用户紫V信息不存在&quot;}

</code></pre>
<h3>9.58 拒绝紫V邀请</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/updatePurpleInvitation.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/updatePurpleInvitation.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>invitationID</td><td>邀请函ID</td><td>是</td><td>long</td><td>1 邀请函ID</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>Integer</td><td>1000</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>nickName</td><td>是</td><td>String</td><td>&quot;&quot;</td><td>用户昵称</td></tr><tr><td>返回结果</td><td>leaderID</td><td>是</td><td>Long</td><td>90002773</td><td>家族长ID</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{&quot;result&quot;:1,&quot;retCode&quot;:1000,&quot;nickName &quot;:,&quot;leaderID&quot;:}//result：1拒绝紫V邀请成功

</code></pre>
<h3>9.59 家族金话筒用户列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findFamiyGoldList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findFamiyGoldList.htm?parameter=</a>{familyID:168}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>familyID</td><td>家族ID</td><td>是</td><td>long</td><td>168</td><td>邀请函ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>Integer</td><td>1000</td><td>成功：1000</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作描述：success</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>Json</td><td>&nbsp;</td><td>如模型</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{
result: [
	{
		userID: 900009929,
		createTime: 1573182873000,
		nickName: &quot;大甜瓜&quot;,
		familyID: 168,
		authType: 11
	}
],
retCode: 1000,
retMsg: &quot;success&quot;
}
</code></pre>
<h3>9.60 家族紫V用户列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/findFamilyPurpleList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/findFamilyPurpleList.htm?parameter=</a>{familyID:168}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>familyID</td><td>家族ID</td><td>是</td><td>long</td><td>168</td><td>邀请函ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>Integer</td><td>1000</td><td>成功：1000</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作描述：success</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>Json</td><td>&nbsp;</td><td>如模型</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{
result: [
	{
		userID: 900009929,
		nickName: &quot;大甜瓜&quot;
	}
],
retCode: 1000,
retMsg: &quot;success&quot;
}
</code></pre>
<h3>9.61 查询家族无效签到最近第一期</h3>
<h5>接口作者：宋加彬</h5>
<h5>是否校验token：是</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/invalidFamilySignOnePage.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/invalidFamilySignOnePage.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>Integer</td><td>1000</td><td>成功：1000</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作描述：success</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>Json</td><td>&nbsp;</td><td>如模型</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900009929,
		&quot;nickName&quot;: &quot;大甜瓜&quot;,
		&quot;photo1&quot;: &quot;头像&quot;,
		&quot;familyID&quot;: 168,
		&quot;invalidSign&quot;: 11
	}],
	&quot;drawno&quot;: &quot;期号&quot;,
	&quot;retCode&quot;: 1000,
	&quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>9.62 查询家族无效签到最近第二期</h3>
<h5>接口作者：宋加彬</h5>
<h5>是否校验token：是</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/invalidFamilySignTwoPage.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/invalidFamilySignTwoPage.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>Integer</td><td>1000</td><td>成功：1000</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作描述：success</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>Json</td><td>&nbsp;</td><td>如模型</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{
	&quot;result&quot;: [{
		&quot;userID&quot;: 900009929,
		&quot;nickName&quot;: &quot;大甜瓜&quot;,
		&quot;photo1&quot;: &quot;头像&quot;,
		&quot;familyID&quot;: 168,
		&quot;invalidSign&quot;: 11
	}],
	&quot;drawno&quot;: &quot;期号&quot;,
	&quot;retCode&quot;: 1000,
	&quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>9.63 查询家族创收奖励入口白名单</h3>
<h5>接口作者：宋加彬</h5>
<h5>是否校验token：是</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/selectFamilyInletWhite.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/selectFamilyInletWhite.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>Integer</td><td>1000</td><td>成功：1000</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作描述：success</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>Json</td><td>&nbsp;</td><td>如模型 1 开放入口 0 无效</td></tr></tbody>
</table></figure>
<h5>返回JSON</h5>
<pre><code>{
	&quot;result&quot;:1 ,
	&quot;retCode&quot;: 1000,
	&quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h2>10、自建比赛相关接口</h2>
<h3>10.1、创建自建比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/createMatch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/createMatch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛封面图片地址</td><td>matchCover</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛封面图片地址</td></tr><tr><td>比赛名称</td><td>matchName</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛名称</td></tr><tr><td>比赛介绍</td><td>matchIntroduce</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛介绍</td></tr><tr><td>比赛规则</td><td>matchRule</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛规则</td></tr><tr><td>参赛对象要求</td><td>entryRequirement</td><td>否</td><td>String</td><td>&nbsp;</td><td>参赛对象要求</td></tr><tr><td>比赛曲目</td><td>matchSong</td><td>否</td><td>String</td><td>&nbsp;</td><td>比赛曲目</td></tr><tr><td>比赛开始时间</td><td>mathchStartTime</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛开始时间</td></tr><tr><td>比赛结束时间</td><td>mathchEndTime</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛结束时间</td></tr><tr><td>排名规则</td><td>rankingRules</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>排名规则1按乐币排2按热度排</td></tr><tr><td>比赛奖品</td><td>matchPrize</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛奖品</td></tr><tr><td>是否公开比赛信息</td><td>isOpenInfo</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否公开比赛信息</td></tr><tr><td>比赛ID</td><td>matchID</td><td>否</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr><tr><td>比赛类型</td><td>matchType</td><td>是</td><td>int</td><td>&nbsp;</td><td>比赛类型，1是自建比赛，3是拉新比赛</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>自建比赛ID</td><td>matchId</td><td>是</td><td>int</td><td>&nbsp;</td><td>自建比赛ID</td></tr></tbody>
</table></figure>
<h3>10.2、预览自建比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/previewMatch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/previewMatch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛封面图片地址</td><td>matchCover</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛封面图片地址</td></tr><tr><td>比赛名称</td><td>matchName</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛名称</td></tr><tr><td>比赛介绍</td><td>matchIntroduce</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛介绍</td></tr><tr><td>比赛规则</td><td>matchRule</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛规则</td></tr><tr><td>参赛对象要求</td><td>entryRequirement</td><td>否</td><td>String</td><td>&nbsp;</td><td>参赛对象要求</td></tr><tr><td>比赛曲目</td><td>matchSong</td><td>否</td><td>String</td><td>&nbsp;</td><td>比赛曲目</td></tr><tr><td>比赛开始时间</td><td>mathchStartTime</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛开始时间</td></tr><tr><td>比赛结束时间</td><td>mathchEndTime</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛结束时间</td></tr><tr><td>排名规则</td><td>rankingRules</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>排名规则1按乐币排2按热度排</td></tr><tr><td>比赛奖品</td><td>matchPrize</td><td>是</td><td>String</td><td>&nbsp;</td><td>比赛奖品</td></tr><tr><td>是否公开比赛信息</td><td>isOpenInfo</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否公开比赛信息</td></tr><tr><td>比赛ID</td><td>matchID</td><td>否</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr><tr><td>比赛类型</td><td>matchType</td><td>是</td><td>int</td><td>&nbsp;</td><td>比赛类型，1是自建比赛，3是拉新比赛</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>比赛ID</td><td>matchId</td><td>是</td><td>int</td><td>&nbsp;</td><td>自建比赛ID</td></tr></tbody>
</table></figure>
<h3>10.3、查看自建比赛详情</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/matchDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/matchDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛ID</td><td>matchID</td><td>否</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>自建比赛详情</td><td>match</td><td>是</td><td>SpaceActivity</td><td>&nbsp;</td><td>自建比赛详情</td></tr><tr><td>创建者信息</td><td>createUser</td><td>是</td><td>SpaceUser</td><td>&nbsp;</td><td>创建者信息</td></tr><tr><td>是否是比赛创建者</td><td>isCreateUser</td><td>是</td><td>1或者0</td><td>&nbsp;</td><td>1是0不是</td></tr><tr><td>是否关注了比赛</td><td>isFocus</td><td>是</td><td>1或者0</td><td>&nbsp;</td><td>1是0不是</td></tr></tbody>
</table></figure>
<h5>自建比赛详情模型 SpaceActivity</h5>
<pre><code>	private String name;			//比赛名称
	private String coverChart;		//比赛封面图
	private String introduction;	//比赛简介
	private String contestRules;	//比赛规则
	private String selectionRules;	//评选规则
	private String prizeDes;		//奖品描述
	private String prizePicture;	//奖品图片
	private String results;			//结果公布
	private Date startTime;			//比赛开始时间
	private Date endTime;			//比赛结束时间
	private Date updatetime;		//比赛更新时间
	private Date createtime;		//比赛创建时间
	private Integer status;			//活动状态，0无效，1有效
	private Integer ztFlag;			//上传作品图标
	private Long createVvId;		//创建人
	private Long updateVvId;		//修改人
	private String otherInfo;		//其他信息
	private Integer type;			//活动类型，0是官方活动1是自建比赛
	private String entryRequirement;//参赛对象要求
    private Integer rankingRules;	//排名规则1按乐币排，2按热度排
    private Integer isOpenInfo;		//是否公开信息，0不公开，1公开
	private Integer isLimitSong;	//是否限制歌曲0不限制，1限制
	private Integer isDisabled;		//是否禁用，0不禁用，1禁用
	private String disabledReason;	//禁用原因
	private String remark;			//备注
	
</code></pre>
<h3>10.4、查看自建比赛列表（自建和参与）</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/matchList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/matchList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>当前页数</td><td>curPage</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前页数</td></tr><tr><td>每页个数</td><td>viewNumber</td><td>是</td><td>int</td><td>&nbsp;</td><td>每页个数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>自建比赛和参与比赛列表</td><td>allMatchList</td><td>是</td><td>List<SpaceActivity></td><td>&nbsp;</td><td>自建比赛和参与比赛列表</td></tr></tbody>
</table></figure>
<h5>自建比赛详情模型 SpaceActivity</h5>
<pre><code>	private String name;			//比赛名称
	private String coverChart;		//比赛封面图
	private String introduction;	//比赛简介
	private String contestRules;	//比赛规则
	private String selectionRules;	//评选规则
	private String prizeDes;		//奖品描述
	private String prizePicture;	//奖品图片
	private String results;			//结果公布
	private Date startTime;			//比赛开始时间
	private Date endTime;			//比赛结束时间
	private Date updatetime;		//比赛更新时间
	private Date createtime;		//比赛创建时间
	private Integer status;			//活动状态，0无效，1有效
	private Integer ztFlag;			//上传作品图标
	private Long createVvId;		//创建人
	private Long updateVvId;		//修改人
	private String otherInfo;		//其他信息
	private Integer type;			//活动类型，0是官方活动1是自建比赛
	private String entryRequirement;//参赛对象要求
    private Integer rankingRules;	//排名规则1按乐币排，2按热度排
    private Integer isOpenInfo;		//是否公开信息，0不公开，1公开
	private Integer isLimitSong;	//是否限制歌曲0不限制，1限制
	private Integer isDisabled;		//是否禁用，0不禁用，1禁用
	private String disabledReason;	//禁用原因
	private String remark;			//备注
</code></pre>
<h3>10.5、关注自建比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/focusMatch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/focusMatch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛ID</td><td>matchID</td><td>是</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>result</td><td>&nbsp;</td><td>关注比赛返回值,1是成功</td></tr></tbody>
</table></figure>
<h4>注意</h4>
<p>比赛创建人不能关注自己创建的比赛！！！</p>
<h3>10.6、取消关注自建比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/cancleFocusMatch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/cancleFocusMatch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛ID</td><td>matchID</td><td>是</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>result</td><td>&nbsp;</td><td>取消关注比赛返回值,1是成功</td></tr></tbody>
</table></figure>
<h3>10.7 加入自建比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/joinMatch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/joinMatch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛ID</td><td>matchID</td><td>是</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>result</td><td>&nbsp;</td><td>加入比赛,1是成功</td></tr></tbody>
</table></figure>
<h3>10.8 退出自建比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/quitMatch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/quitMatch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>比赛ID</td><td>matchID</td><td>是</td><td>int</td><td>&nbsp;</td><td>比赛ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>result</td><td>&nbsp;</td><td>退出比赛,1是成功</td></tr></tbody>
</table></figure>
<h3>10.9 更改参赛作品比赛ID</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/updateSpaceAv.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/updateSpaceAv.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>比赛ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>比赛ID</td></tr><tr><td>参赛作品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>参赛作品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>result</td><td>&nbsp;</td><td>更新参赛作品结果,1是成功</td></tr></tbody>
</table></figure>
<h3>11.1 查询歌房奖励账户余额</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/qryFamilyAccount.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/qryFamilyAccount.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>pRoomResult</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>查询结果0 失败 1 成功 2 锁定</td></tr><tr><td>返回结果</td><td>pFamilyMoney</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族帐户余额</td></tr><tr><td>返回结果</td><td>pUpMoney</td><td>是</td><td>Long</td><td>&nbsp;</td><td>上期奖励</td></tr><tr><td>返回结果</td><td>pDayMoney</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族帐户今日可提现金额</td></tr><tr><td>返回结果</td><td>pUpTicket</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族帐户上期音符收入</td></tr><tr><td>返回结果</td><td>pUpAward</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族帐户上期音符收入奖励比例</td></tr></tbody>
</table></figure>
<h3>11.2 查询三个月用户账户明细</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/detailedFamilyMoneyLog.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/detailedFamilyMoneyLog.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>detailedAccountFamilyLogList</td><td>是</td><td>List<AccountFamilyLog></td><td>&nbsp;</td><td>明细list，详情见下面</td></tr></tbody>
</table></figure>
<h4>AccountFamilyLog详细信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>logID</td><td>是</td><td>Long</td><td>1000</td><td>id</td></tr><tr><td>返回结果</td><td>familyID</td><td>是</td><td>Long</td><td>1</td><td>家族ID</td></tr><tr><td>返回结果</td><td>oldCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>帐号原来的数量</td></tr><tr><td>返回结果</td><td>changeCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>变化数量</td></tr><tr><td>返回结果</td><td>newCount</td><td>是</td><td>Long</td><td>&nbsp;</td><td>帐号修改之后的数量</td></tr><tr><td>返回结果</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>操作类型 1歌房奖励发放 2提现回退 50提现 51购买乐币</td></tr><tr><td>返回结果</td><td>reason</td><td>是</td><td>String</td><td>&nbsp;</td><td>操作类型说明</td></tr><tr><td>返回结果</td><td>extID</td><td>是</td><td>String</td><td>&nbsp;</td><td>操作相关参数，1家族ID_奖励期号 2和50提现ID 51乐币变动ID</td></tr><tr><td>返回结果</td><td>createTime</td><td>是</td><td>String</td><td>&nbsp;</td><td>创建时间</td></tr><tr><td>返回结果</td><td>bankState</td><td>是</td><td>String</td><td>&nbsp;</td><td>银行卡提现状态</td></tr><tr><td>返回结果</td><td>bankInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>银行卡提现信息展示</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>11.3 家族申请提现</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/familyApplyWithdraw.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/familyApplyWithdraw.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>提现金额</td><td>amount</td><td>是</td><td>long</td><td>&nbsp;</td><td>提现金额</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>11.4 查询购买乐币奖励所得总金额</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/qryFamilyExchangeDiamond.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/qryFamilyExchangeDiamond.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>兑换金额</td><td>exchangeMoney</td><td>是</td><td>long</td><td>&nbsp;</td><td>兑换金额</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>pResult</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>兑换结果 0 失败 1 成功 2 余额不足 3 可兑换乐币数为0 4 兑换金额不符合规定 5 账户锁定不可以兑换</td></tr><tr><td>返回结果</td><td>pToalCount</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>兑换乐币总数</td></tr><tr><td>返回结果</td><td>pBuyCount</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>购买乐币数量</td></tr><tr><td>返回结果</td><td>pGiveCount</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>赠送乐币数量</td></tr></tbody>
</table></figure>
<h3>11.5 家族奖励购买乐币</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/familyExchangeDiamond.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/familyExchangeDiamond.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>购买金额</td><td>exchangeMoney</td><td>是</td><td>long</td><td>&nbsp;</td><td>购买金额</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>pResult</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>兑换结果 0 失败 1 成功 2 余额不足 3 可兑换乐币数为0 4 兑换金额不符合规定 5 账户锁定不可以兑换</td></tr></tbody>
</table></figure>
<h3>12.1、地区列表</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getPositionList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getPositionList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------| ------| ----| -----| ------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>位置数据</td><td>positionInfo</td><td>否</td><td>对象</td><td>&nbsp;</td><td>位置数据</td></tr></tbody>
</table></figure>
<h5>positionInfo模型定义</h5>
<pre><code>private List&lt;ProvinceInfo&gt;  provinceInfoList;
private Long positionCode;//省code
private Long cityCode;//城市code
private String  cityName;//城市名称
</code></pre>
<h5>provinceInfoList模型定义</h5>
<pre><code>private Long positionCode;
private String positionName;
private int positionState;//0:未选中;1已选中
</code></pre>
<h3>12.2、同城列表</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getCityDataList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getCityDataList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>省code</td><td>positionCode</td><td>否</td><td>Long</td><td>省code</td><td>省code和城市code二选一</td></tr><tr><td>城市code</td><td>cityCode</td><td>否</td><td>Long</td><td>城市code</td><td>省code和城市code二选一</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>int</td><td>1</td><td>每页的长度  默认10，最大20(优先)</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>int</td><td>888888</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>同城数据</td><td>cityResult</td><td>否</td><td>对象</td><td>&nbsp;</td><td>同城数据</td></tr></tbody>
</table></figure>
<h5>cityResult 模型定义</h5>
<pre><code>private List&lt;CityData&gt; cityDataList;
private Boolean hasNext;//下次有无数据
</code></pre>
<h5>cityData 模型定义</h5>
<pre><code>private SpaceUser user; //用户信息
private AddressInfo addInfo;//距离信息
private AvInfo avInfo;//作品信息
private LiveInfo liveInfo;//直播信息
private RoomInfo roomInfo;//歌房信息
</code></pre>
<h5>SpaceUser 模型定义</h5>
<pre><code>private String userID;
private String nickname;//昵称
private String photo1;// 头像
private List vip;// 201:会员
private Long level_wealth; //财富等级
private String gender;//性别 F:女 M:男
private Short authType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
</code></pre>
<h5>AddressInfo 模型定义</h5>
<pre><code>private String gpsAddress;经纬度
private Long positionCode; //省code
private String positionName;//省份名称
private Long cityCode; //城市code
private String cityName;// 城市名称

</code></pre>
<h5>AvInfo 模型定义</h5>
<pre><code>private Long avID;//音视频ID
private String description;作品描述
private String cover;//作品封面
private String name;//作品名称
private Short fileType;// 作品类型 1 原创 2 翻唱 3 伴奏 4 视频
private date publishDate;// 发布时间
private Integer playTimes;// 试听次数
private Integer praiseTimes;// 点赞次数
private Integer commentTimes;// 评论次数
private Integer shareTimes;// 分享次数
private Short exFileType;//0 独唱 1 合唱 2 半成品
private Long semiUserID;           //发起合唱用户ID
private Short semiUserAuthType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
private String semiUserPhoto;           //发起合唱用户ID
private Integer chorusNum;//合唱次数

</code></pre>
<h5>LiveInfo 模型定义</h5>
<pre><code>private Long liveID;//直播ID
private String description;直播主题
private String liveCover;//直播封面
private Long onlineCount;// 直播间人数
private Short state;// 状态.0 直播未开始  1 直播中   2 直播关闭  3 回看中   4   删除   5 回看生成中   6 回看生成失败

</code></pre>
<h5>RoomInfo 模型定义</h5>
<pre><code>private Long roomID;//直播ID
private String roomName;歌房标题
private String cover;//歌房封面
private Long onlineCount;// 歌房人数
private Integer roomStatus;// 房间状态，0 关闭（解散）；1 开启
private Integer micCount;// 当前麦序人数
</code></pre>
<h3>12.3、根据省查询市</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getAllCityByProvinceCode.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getAllCityByProvinceCode.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>省code</td><td>positionCode</td><td>是</td><td>1001</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>位置数据</td><td>cityDataList</td><td>否</td><td>集合</td><td>&nbsp;</td><td>位置数据</td></tr></tbody>
</table></figure>
<h5>cityData模型定义</h5>
<pre><code>private Long cityCode; //城市code
private String cityName;//城市名称
private Short cityState;//0:未选中;1已选中
</code></pre>
<h3>12.4、查询热门城市</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getRecommendCityList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getRecommendCityList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------| ------| ----| -----| ------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>位置数据</td><td>recommendResult</td><td>否</td><td>集合</td><td>&nbsp;</td><td>位置数据</td></tr></tbody>
</table></figure>
<h5>recommendResult模型定义</h5>
<pre><code>private Long positionCode;//省code
private String positionName;//省名称
private Long cityCode; //城市code
private String cityName;//城市名称
</code></pre>
<h3>12.5、app同城列表</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getAppCityDataList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getAppCityDataList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>坐标经度</td><td>gpsY</td><td>否</td><td>String</td><td>坐标经度</td><td>&nbsp;</td></tr><tr><td>坐标纬度</td><td>gpsX</td><td>否</td><td>String</td><td>坐标纬度</td><td>&nbsp;</td></tr><tr><td>省code</td><td>positionCode</td><td>否</td><td>Long</td><td>省code</td><td>省code和城市code二选一</td></tr><tr><td>城市code</td><td>cityCode</td><td>否</td><td>Long</td><td>城市code</td><td>省code和城市code二选一</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>int</td><td>1</td><td>每页的长度  默认10，最大20(优先)</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>int</td><td>888888</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>同城数据</td><td>cityResult</td><td>否</td><td>对象</td><td>&nbsp;</td><td>同城数据</td></tr></tbody>
</table></figure>
<h5>cityResult 模型定义</h5>
<pre><code>private List&lt;CityData&gt; cityDataList;
private Boolean hasNext;//下次有无数据
private Long positionCode;//省code
private String positionName;//省名称
private Long cityCode; //城市code
private String cityName;//城市名称
</code></pre>
<h5>cityData 模型定义</h5>
<pre><code>private SpaceUser user; //用户信息
private AddressInfo addInfo;//距离信息
private AvInfo avInfo;//作品信息
private LiveInfo liveInfo;//直播信息
private RoomInfo roomInfo;//歌房信息
private Integer type;// 1:新作品;2:亲密度;null:普通
private SpaceUser friendUser;//亲密度好友信息
</code></pre>
<h5>SpaceUser 模型定义</h5>
<pre><code>private String userID;
private String nickname;//昵称
private String photo1;// 头像
private List vip;// 201:会员
private Long level_wealth; //财富等级
private String gender;//性别 F:女 M:男
private Short authType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
private String pendant;//挂件
</code></pre>
<h5>AddressInfo 模型定义</h5>
<pre><code>private String gpsAddress;经纬度
private Long positionCode; //省code
private String positionName;//省份名称
private Long cityCode; //城市code
private String cityName;// 城市名称

</code></pre>
<h5>AvInfo 模型定义</h5>
<pre><code>private Long avID;//音视频ID
private String description;作品描述
private String cover;//作品封面
private String name;//作品名称
private Short fileType;// 作品类型 1 原创 2 翻唱 3 伴奏 4 视频
private date publishDate;// 发布时间
private Integer playTimes;// 试听次数
private Integer praiseTimes;// 点赞次数
private Integer commentTimes;// 评论次数
private Integer shareTimes;// 分享次数
private Short exFileType;//0 独唱 1 合唱 2 半成品
private Long semiUserID;           //发起合唱用户ID
private Short semiUserAuthType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
private String semiUserPhoto;           //发起合唱用户ID
private String semiUserNickName;           //发起合唱用户昵称
private String semiPendant;// 发起合唱用户挂件
private Integer chorusNum;//合唱次数
private Short zpSource;//&#39;作品来源 0 翻唱曲库 1 清唱 2 本地歌曲&#39;

</code></pre>
<h5>LiveInfo 模型定义</h5>
<pre><code>private Long liveID;//直播ID
private String description;直播主题
private String liveCover;//直播封面 已包含coverImgUrl 或photo1
private Long onlineCount;// 直播间人数
private Short state;// 状态.0 直播未开始  1 直播中   2 直播关闭  3 回看中   4   删除   5 回看生成中   6 回看生成失败
private Integer liveType; //1视频，2音频
private String backgroundImgUrl;//背景图
</code></pre>
<h5>RoomInfo 模型定义</h5>
<pre><code>private Long roomID;//直播ID
private String roomName;歌房标题
private String cover;//歌房封面
private Long onlineCount;// 歌房人数
private Integer roomStatus;// 房间状态，0 关闭（解散）；1 开启
private Integer micCount;// 当前麦序人数
</code></pre>
<h3>12.6、app切换地区列表</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getAppPositionList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getAppPositionList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------| ------| ----| -----| ------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>位置数据</td><td>appPositionList</td><td>否</td><td>集合</td><td>&nbsp;</td><td>城市数据</td></tr></tbody>
</table></figure>
<h5>appPositionList模型定义</h5>
<pre><code>private String provinceFirstChar; // 省字符简称
private List&lt;AppProvinceInfo&gt;  provinceInfoList;// 省集合
</code></pre>
<h5>provinceInfoList模型定义</h5>
<pre><code>private Long positionCode;//省code
private String positionName;//省名称
</code></pre>
<h3>12.7、app根据省查询市</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getAppAllCityByProvinceCode.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getAppAllCityByProvinceCode.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>省code</td><td>positionCode</td><td>是</td><td>1001</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>resMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>位置数据</td><td>cityInfoList</td><td>否</td><td>集合</td><td>&nbsp;</td><td>位置数据</td></tr></tbody>
</table></figure>
<h5>cityInfo模型定义</h5>
<pre><code>private Long cityCode; //城市code
private String cityName;//城市名称
</code></pre>
<h3>13.1 查询银行列表</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/selectCodeBankList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/selectCodeBankList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>List<CodeBank></td><td>&nbsp;</td><td>明细list，详情见下面</td></tr></tbody>
</table></figure>
<h4>CodeBank详细信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>indexno</td><td>是</td><td>Integer</td><td>1000</td><td>排序值</td></tr><tr><td>返回结果</td><td>bankName</td><td>是</td><td>String</td><td>中国招商银行</td><td>银行名称</td></tr><tr><td>返回结果</td><td>bankCode</td><td>是</td><td>String</td><td>&nbsp;</td><td>银行缩写</td></tr></tbody>
</table></figure>
<h3>13.2 查询省份信息列表</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/selectCodeProvinceList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/selectCodeProvinceList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>List<CodeProvince></td><td>&nbsp;</td><td>明细list，详情见下面</td></tr></tbody>
</table></figure>
<h4>CodeProvince详细信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>provinceID</td><td>是</td><td>String</td><td>1000</td><td>省份id</td></tr><tr><td>返回结果</td><td>provinceName</td><td>是</td><td>String</td><td>吉林省</td><td>省份名称</td></tr></tbody>
</table></figure>
<h3>13.3 根据省份id查询市信息</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/selectCodeCityByProvinceID.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/selectCodeCityByProvinceID.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>省份id</td><td>provinceID</td><td>是</td><td>String</td><td>1214</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>List<CodeCity></td><td>&nbsp;</td><td>明细list，详情见下面</td></tr></tbody>
</table></figure>
<h4>CodeCity详细信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>cityID</td><td>是</td><td>String</td><td>1000</td><td>市id</td></tr><tr><td>返回结果</td><td>provinceID</td><td>是</td><td>String</td><td>1000</td><td>省份id</td></tr><tr><td>返回结果</td><td>cityName</td><td>是</td><td>String</td><td>吉林省</td><td>市名称</td></tr></tbody>
</table></figure>
<h3>13.4 修改用户手动提现信息（大额提现）</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/updateDrawHandInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/updateDrawHandInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>省份名称</td><td>provinceName</td><td>是</td><td>String</td><td>吉林省</td><td>&nbsp;</td></tr><tr><td>市名称</td><td>cityName</td><td>是</td><td>String</td><td>长春市</td><td>&nbsp;</td></tr><tr><td>银行名称</td><td>bankName</td><td>是</td><td>String</td><td>中国农业银行</td><td>&nbsp;</td></tr><tr><td>开户行</td><td>bankOpen</td><td>是</td><td>String</td><td>大屯路支行</td><td>&nbsp;</td></tr><tr><td>银行卡号</td><td>bankAccount</td><td>是</td><td>String</td><td>622123455666666855</td><td>&nbsp;</td></tr><tr><td>用户手机号</td><td>mobile</td><td>是</td><td>String</td><td>13811112222</td><td>&nbsp;</td></tr><tr><td>身份证正面照片</td><td>papersNumberImg1</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证反面照片</td><td>papersNumberImg2</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>手机验证码</td><td>mobileRandomCode</td><td>是</td><td>Integer</td><td>1234</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 -1 失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>返回1为修改成功</td></tr></tbody>
</table></figure>
<h3>13.5 根据用户id查询手动提现信息</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/selectDrawHandInfoByUserId.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/selectDrawHandInfoByUserId.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 -1 失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>retMap</td><td>&nbsp;</td><td>retMap详情见下面</td></tr></tbody>
</table></figure>
<h4>retMap详细信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userid</td><td>是</td><td>Long</td><td>98744455</td><td>&nbsp;</td></tr><tr><td>状态</td><td>state</td><td>是</td><td>Integer</td><td>1</td><td>状态 0 待提交 1 待审核 2 审核通过 3 审核不通过 -1 作废</td></tr><tr><td>身份证号</td><td>papersNumber</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>真实姓名</td><td>userRealName</td><td>是</td><td>String</td><td>张富贵</td><td>&nbsp;</td></tr><tr><td>省份名称</td><td>provinceName</td><td>是</td><td>String</td><td>吉林省</td><td>&nbsp;</td></tr><tr><td>市名称</td><td>cityName</td><td>是</td><td>String</td><td>长春市</td><td>&nbsp;</td></tr><tr><td>银行名称</td><td>bankName</td><td>是</td><td>String</td><td>中国农业银行</td><td>&nbsp;</td></tr><tr><td>开户行</td><td>bankOpen</td><td>是</td><td>String</td><td>大屯路支行</td><td>&nbsp;</td></tr><tr><td>银行卡号</td><td>bankAccount</td><td>是</td><td>String</td><td>622123455666666855</td><td>&nbsp;</td></tr><tr><td>用户手机号</td><td>mobile</td><td>是</td><td>String</td><td>13811112222</td><td>&nbsp;</td></tr><tr><td>身份证正面照片</td><td>papersNumberImg1</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证反面照片</td><td>papersNumberImg2</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>创建时间</td><td>createTime</td><td>是</td><td>Date</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>修改时间</td><td>updateTime</td><td>是</td><td>Date</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>审核信息</td><td>stateInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>13.6 查询是否允许用户大额提现</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/isGetDrawHandInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/isGetDrawHandInfo.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 -1 失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>1允许0不允许</td></tr></tbody>
</table></figure>
<h3>13.7 获取用户手动提现的手机验证码</h3>
<h4>接口作者：刘冰</h4>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdraw/drawHandInfoSmsSendMessage.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdraw/drawHandInfoSmsSendMessage.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>手机号码</td><td>mobile</td><td>是</td><td>String</td><td>18611112222</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果值</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 返回其他值都是失败：-101:服务器ip错误,-102:服务器签名错误,-103:格式错误,101:次数受限制,-104:手机号码错误,107:次数受限制 超过一天的限制。返回其他值都是失败</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>14.1 查询用户是否是内测用户</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/common/queryInternalTest.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/common/queryInternalTest.htm?parameter=</a>{&quot;userID&quot;:&quot;900002482&quot;,&quot;clientVersion&quot;:&quot;5.2.31&quot;}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>userID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>clientVersion</td><td>clientVersion</td><td>是</td><td>String</td><td>&nbsp;</td><td>客户端版本号</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10002 参数异常。</td></tr><tr><td>校验结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>1是内存用户 ，0不是。</td></tr><tr><td>result为1返回</td><td>detail</td><td>否</td><td>String</td><td>&nbsp;</td><td>文案</td></tr><tr><td>result为1返回</td><td>downloadUrl</td><td>否</td><td>int</td><td>&nbsp;</td><td>下载地址</td></tr></tbody>
</table></figure>
<h3>15.1 新增送礼匿名关系</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/addNameless.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/addNameless.htm?parameter=</a>{userIDs:&quot;900002482,900002773&quot;}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ids</td><td>userIDs</td><td>是</td><td>String</td><td>&quot;900002482,900002773&quot;</td><td>多个用户ID，最多200个</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败,1002 参数错误，1003 不是会员</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>15.2 分页查询的我所有的匿名关系列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/queryNamelessList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/queryNamelessList.htm?parameter=</a>{curPage:1,viewNumber:20}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>匿名关系列表</td><td>result</td><td>是</td><td>List<SpaceUserNameless></td><td>&nbsp;</td><td>匿名关系列表</td></tr></tbody>
</table></figure>
<h5>匿名关系对象模型 SpaceUserNameless</h5>
<pre><code>	private Short status; 			//匿名关系状态值  1有效0无效
    private Date createtime;		//创建时间
    private Date updatetime;		//更新时间
	private Long userId;			//当前登录人userID
    private Long namelessUserId;	//匿名人的userID
</code></pre>
<h3>15.3 查询我和某一个人的匿名关系</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/queryNamelessRecord.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/queryNamelessRecord.htm?parameter=</a>{userID:900006450}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>匿名人的userID</td><td>userID</td><td>是</td><td>Long</td><td>900006450</td><td>匿名人的userID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>是否是匿名关系</td><td>result</td><td>是</td><td>int</td><td>1</td><td>是否是匿名关系.1是，0不是</td></tr></tbody>
</table></figure>
<h3>15.4 查询我和一些人的匿名关系</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/findNamelessRelations.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/findNamelessRelations.htm?parameter=</a>{userIDs:&quot;900002773,900006450&quot;}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>这些匿名人的userIDs</td><td>userIDs</td><td>是</td><td>String</td><td>&quot;900002773,900006450&quot;</td><td>这些匿名人的userIDs</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>是否是匿名关系</td><td>relationMapList</td><td>是</td><td>List</td><td>[{&quot;userID&quot;:900002773,&quot;state&quot;:1}]</td><td>是否是匿名关系,state值是1代表是，0代表不是。</td></tr></tbody>
</table></figure>
<h3>15.5 删除匿名关系</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/updateNameless.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/updateNameless.htm?parameter=</a>{userID:900002773}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>匿名人的userID</td><td>userID</td><td>是</td><td>Long</td><td>900002773</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>更新结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>是否更新成功：1更新成功</td></tr></tbody>
</table></figure>
<h3>15.6 查询当前登录人是否在白名单列表中</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/getIsInWhiteList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/getIsInWhiteList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>更新结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>是否在白名单里：1在，0不在</td></tr></tbody>
</table></figure>
<h3>15.7 分页查询的我所有的匿名关系列表带时间戳</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/queryNamelessListTimestamp.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/queryNamelessListTimestamp.htm?parameter=</a>{curPage:1,viewNumber:20,timestamp:1550543252}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>时间戳</td><td>timestamp</td><td>是</td><td>Long</td><td>1550543252</td><td>时间戳</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>匿名关系列表</td><td>result</td><td>是</td><td>List<SpaceUserNameless></td><td>&nbsp;</td><td>匿名关系列表</td></tr></tbody>
</table></figure>
<h5>匿名关系对象模型 SpaceUserNameless</h5>
<pre><code>	private Short status; 			//匿名关系状态值  1有效 0无效
    private Date createtime;		//创建时间
    private Date updatetime;		//更新时间
	private Long userId;			//当前登录人userID
    private Long namelessUserId;	//匿名人的userID
</code></pre>
<h3>15.8 批量查询用户信息</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/less/queryBathSpaceUser.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/less/queryBathSpaceUser.htm?parameter=</a>{userIDs:&quot;900006450,900002773&quot;}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ids</td><td>userIDs</td><td>是</td><td>String</td><td>&quot;900002482,900002773&quot;</td><td>多个用户ID，最多20个</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001，参数错误</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>返回用户集合</td><td>spaceUserList</td><td>是</td><td>List<SpaceUser></td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr></tbody>
</table></figure>
<h5>SpaceUser 模型定义</h5>
<pre><code>private String userID;
private String nickname;//昵称
private String photo1;// 头像
private Integer level;// 活跃等级
private Long level_singer;//歌手等级
private Integer vip;// 是否是VIP，1是，0不是
</code></pre>
<h3>15.11 新增隐身访问</h3>
<h5>接口作者：温志广</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/stealthaccess/add.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/stealthaccess/add.htm?parameter=</a>{userIDs:&quot;900002482,900002773&quot;}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ids</td><td>userIDs</td><td>是</td><td>String</td><td>&quot;900002482,900002773&quot;</td><td>多个用户ID，最多20个</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 1001参数错误 1005操作失败 1204隐身访问超过上限</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>插入成功的用户列表</td><td>spaceUserList</td><td>是</td><td>List<SpaceUser></td><td>&nbsp;</td><td>插入成功的用户列表</td></tr></tbody>
</table></figure>
<h5>SpaceUser 模型定义</h5>
<pre><code>private String userID;
private String nickname;//昵称
private String photo1;// 头像
private Integer level;// 活跃等级
private Long level_singer;//歌手等级
private Integer isVip;// 是否是VIP，1是，0不是
</code></pre>
<h3>15.12 删除隐身访问</h3>
<h5>接口作者：温志广</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/stealthaccess/remove.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/stealthaccess/remove.htm?parameter=</a>{userID:900002773}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>对象userID</td><td>userID</td><td>是</td><td>Long</td><td>900006450</td><td>对象userID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>15.13 查询是否隐身访问</h3>
<h5>接口作者：温志广</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/stealthaccess/query.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/stealthaccess/query.htm?parameter=</a>{userID:900006450}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>对象userID</td><td>userID</td><td>是</td><td>Long</td><td>900006450</td><td>对象userID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>是否隐身访问</td><td>result</td><td>是</td><td>int</td><td>1</td><td>是否隐身访问.1是，0不是</td></tr></tbody>
</table></figure>
<h3>15.14 查询隐身访问列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/stealthaccess/queryList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/stealthaccess/queryList.htm?parameter=</a>{curPage:1,viewNumber:20}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>总数</td><td>totalNum</td><td>是</td><td>Long</td><td>0</td><td>总数</td></tr><tr><td>用户列表</td><td>spaceUserList</td><td>是</td><td>List<SpaceUser></td><td>&nbsp;</td><td>用户列表</td></tr></tbody>
</table></figure>
<h5>SpaceUser 模型定义</h5>
<pre><code>private String userID;
private String nickname;//昵称
private String photo1;// 头像
private Integer level;// 活跃等级
private Long level_singer;//歌手等级
private Integer isVip;// 是否是VIP，1是，0不是
</code></pre>
<h3>15.15 批量查询是否隐身访问</h3>
<h5>接口作者：温志广</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/user/stealthaccess/queryBatch.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/stealthaccess/queryBatch.htm?parameter=</a>{userIDs:&quot;900006450,20007&quot;}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>对象userID</td><td>userID</td><td>是</td><td>Long</td><td>900006450</td><td>对象userID，不能超过200个</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>列表</td><td>list</td><td>是</td><td>Map</td><td>&nbsp;</td><td>列表</td></tr></tbody>
</table></figure>
<h5>列表模型</h5>
<pre><code>	private Long userID;
    private int result;   //是否隐身访问.1是，0不是
</code></pre>
<h3>16.1 查询女王降临</h3>
<h5>接口作者：李志勇</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/queryGoddessInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/queryGoddessInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>榜单类型</td><td>type</td><td>是</td><td>Integer</td><td>1</td><td>1：女王榜；2：骑士榜</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>GoddessInfo</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>GoddessInfo</h5>
<pre><code>	private MyBillInfo myBillInfo; 			//人员信息及排名
    private List&lt;Billboard&gt; billboardList;		//女王榜单
</code></pre>
<h5>MyBillInfo</h5>
<pre><code>	private Long userID;
    private String nickname;
	private String photo1;
	private Long goddessNum;//女王值
	private Integer goddessRank;//女王排名
	private Long guardNum;//骑士值
	private Integer guardRank;//骑士排名
</code></pre>
<h5>Billboard</h5>
<pre><code>	private Long goddesUserID; //女王userID
    private String goddessNickname;//女王昵称
	private String goddessPhoto1;//女王头像
	private Long goddessNum;//女王值
	private Long liveID;//直播ID
	private Long guardUserID; //骑士userID
    private String guardNickname;//骑士昵称
	private String guardPhoto1;//骑士头像
	private Long guardNum;//骑士值
	private Boolean anonymousFlag;//匿名标识  true :匿名
</code></pre>
<h3>16.2 查询主播女王排名</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/queryMyGoddessRankInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/queryMyGoddessRankInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播ID</td><td>anchorID</td><td>是</td><td>Long</td><td>900005085</td><td>主播ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>currentLevel</td><td>是</td><td>String</td><td>当前级别</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>rank</td><td>是</td><td>Integer</td><td>女王榜排名</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>nextLevel</td><td>否</td><td>String</td><td>下一级别</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>currentNum</td><td>是</td><td>String</td><td>女神值</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>16.3 查询我的家族申请活动记录</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/queryMyApplyRecord.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/queryMyApplyRecord.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>122071</td><td>家族ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>applyRecord</td><td>是</td><td>集合</td><td>申请记录</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>currentTime</td><td>是</td><td>Long</td><td>当前时间毫秒数</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>applyRecord</h5>
<pre><code>	private Long id;	//活动唯一标识
    private Long familyId;//家族ID
    private Long userId;//申请人家族ID
    private String activityName;
    private String activityTheme;//活动主题
    private Integer activityDate;
    private Date submitTime;//活动提交时间
    private Date activityStartTime;//活动开始时间
    private Date activityEndTime;//活动结束时间
    private String activityType;//活动类型
    private String activityPlace;//活动地点,0直播间，1歌房
    private Long activityPlaceId;//直播间Id/歌房Id
    private String activityPublicityWords;//活动宣传语
    private String activityRules;//活动规则
    private String activityProgram;//活动节目单
    private String publicityVideo;//宣传视频
    private String activityCover;//活动封面
    private Short auditState;//0表示审核中,1表示审核通过,2表示审核未通过
    private String auditReson;//审核理由
    private String reviewLink; // 回顾链接 不是-1时才是链接
</code></pre>
<h3>16.4 验证活动信息(直播或歌房)</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/vaildActivityInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/vaildActivityInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动地点ID</td><td>activityPlace</td><td>是</td><td>int</td><td>0</td><td>0直播间，1家族歌房 2：自建歌房</td></tr><tr><td>人员Id/歌房Id</td><td>activityPlaceId</td><td>是</td><td>Long</td><td>0</td><td>人员Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>name</td><td>是</td><td>String</td><td>直播或歌房昵称</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>16.5 查询活动配置信息</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/queryBaseConfigActivity.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/queryBaseConfigActivity.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>122071</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>draftInfo</td><td>是</td><td>对象</td><td>草稿对象</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>familyName</td><td>是</td><td>String</td><td>家族名称</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>activeConfig</td><td>是</td><td>对象</td><td>配置对象</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>draftInfo</h5>
<pre><code>	private Long id;	//活动唯一标识
    private Long familyId;//家族ID
    private Long userId;//申请人家族ID
    private String activityName;
    private String activityTheme;//活动主题
    private Integer activityDate;
    private Date submitTime;//活动提交时间
    private Date activityStartTime;//活动开始时间
    private Date activityEndTime;//活动结束时间
    private String activityType;//活动类型
    private String activityPlace;//活动地点,0直播间，1歌房
    private Long activityPlaceId;//直播间Id/歌房Id
    private String activityPublicityWords;//活动宣传语
    private String activityRules;//活动规则
    private String activityProgram;//活动节目单
    private String publicityVideo;//宣传视频
    private String activityCover;//活动封面
</code></pre>
<h5>activeConfig</h5>
<pre><code>	private List&lt;ActiveType&gt; activeTypeList; //活动类型集合
    private List&lt;ActiveType&gt; activeAddressList;//活动地点集合
</code></pre>
<h5>ActiveType</h5>
<pre><code>	private Integer menuID;//菜单ID
    private String menuName;//菜单名称
    private List&lt;ActiveGift&gt; activeGiftList;
</code></pre>
<h5>ActiveGift</h5>
<pre><code>	private String name;//礼物描述
    private String photo;//礼物图片
</code></pre>
<h3>16.6 申请家族活动或者存草稿</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<h5>Post请求</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/createActivity.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/createActivity.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动唯一标识</td><td>id</td><td>否</td><td>Long</td><td>0</td><td>活动唯一标识</td></tr><tr><td>申请类型</td><td>auditState</td><td>是</td><td>Integer</td><td>0</td><td>0：申请；1：草稿</td></tr><tr><td>宣传视频</td><td>publicityVideo</td><td>是</td><td>String</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动封面</td><td>activityCover</td><td>是</td><td>String</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动主题</td><td>activityTheme</td><td>是</td><td>String</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动开始时间</td><td>activityStartTime</td><td>是</td><td>String</td><td>0</td><td>yyyy-MM-dd HH:mm:ss</td></tr><tr><td>活动类型</td><td>activityType</td><td>是</td><td>Integer</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动地点</td><td>activityPlace</td><td>是</td><td>Integer</td><td>0</td><td>&nbsp;</td></tr><tr><td>人员Id/歌房Id</td><td>activityPlaceId</td><td>是</td><td>Long</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动宣传语</td><td>activityPublicityWords</td><td>是</td><td>String</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动规则</td><td>activityRules</td><td>是</td><td>String</td><td>0</td><td>&nbsp;</td></tr><tr><td>活动节目单</td><td>activityProgram</td><td>是</td><td>String</td><td>0</td><td>&nbsp;</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>0</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功/11103:歌房/直播间ID不正确/11102:不在申请范围时间内/0607:该用户没有权限申请该活动/0601:此用户不存在/0608:每个月不能超过4场/0609:当日活动数量已满/0610:非草稿不允许修改</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>String</td><td>错误描述</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>16.7 查询家族活动列表</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token(可有可无)</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/match/queryFamilyActivity.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/match/queryFamilyActivity.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>集合</td><td>家族活动列表</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>currentTime</td><td>是</td><td>Long</td><td>当前时间毫秒数</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>applyRecord</h5>
<pre><code>	private Long id;	//活动唯一标识
    private Long familyId;//家族ID
    private Long userId;//申请人家族ID
    private String activityName;
    private String activityTheme;//活动主题
    private Integer activityDate;
    private Date submitTime;//活动提交时间
    private Date activityStartTime;//活动开始时间
    private Date activityEndTime;//活动结束时间
    private String activityType;//活动类型
    private String activityPlace;//活动地点,0直播间，1歌房
    private Long activityPlaceId;//直播间Id/歌房Id
    private String activityPublicityWords;//活动宣传语
    private String activityRules;//活动规则
    private String activityProgram;//活动节目单
    private String publicityVideo;//宣传视频
    private String activityCover;//活动封面
    private Short auditState;//0表示审核中,1表示审核通过,2表示审核未通过
    private String auditReson;//审核理由
    private int onlineCount;//在线人数
    private String reviewLink; // 回顾链接 不是-1时才是链接
</code></pre>
<h3>16.8 查询我的mv作品</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token(必校验)</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/queryMyMvList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/queryMyMvList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>spaceAvList</td><td>是</td><td>集合</td><td>mv作品列表</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>SpaceAv</h5>
<pre><code>	private Long AVID;
    private Long userID;
    private String name;
    private String frontCoverUrl;
    private String tag;
    private String description;
    private Short fileType;
    private String performer;
    private String writer;
    private String composer;
    private String singer;
    private String editor;
    private String MIX;
    private String uploadDomain;
    private String fileDomain;
    private String fileURL;
    private Long fileSize;
    private String fromIP;
    private Short status;
    private Short syncTelecom;
    private Short syncUnicom;
    private Short sideshowBob;
    private Date createTime;
    private Integer playTimes;
    private Integer praiseTimes;
    private Integer commentTimes;
    private Integer shareTimes;
    private Integer KSCSongID;
    private Long updateUserid;
    private Date updateTime;
    private String thumbUrl;
    private Float duration;
    private Float bitrate;
    private String hashCode;
    private Date reviewTime;
    private Integer latest;
    private Integer addPlayTimes;
    private Integer activityId;
    private String reason;
    private Long updateUserid2;
    private Date reviewTime2;
    private Short status1;
    private Integer vvSharetimes;
    private Integer thirdSharetimes;
    private Short checkDescriptionFlag;
    private String descriptionBak;
    private Long descVvId;
    private Date descTime;
    private Short exFileType;
    private Long semiAVID;
    private Short isJXHC;
    private Integer priorityJXHC;
    private Integer chorusNum;
    private Long semiUserID;
    private Integer validCommentTimes;
    private Integer flowerAmount;
    private Short zpSource;
    private String recordParams;
    private Integer validPlayTimes;
    private Integer starLevel;
    private Integer remark;
    private Short privateUpload;
    private Integer uploadfileID;
    private Long giftAmount;
    private Long giftDiamond;
    private Short webUpload;
    private Integer collectTimes;
    private Long partner;
    private Short isAccept;
    private Long acceptedAVID;
    private Short watermark;
    private Short isSemiMv;
    private Short isHcMv;
    private Short reviewCause;
    private Short removeType;
    private Short stick;
    private Date stickTime;
    private Date joinTime;
    private Integer outsidePlayTimes;
    private String lyric;
    private Long redPacketAmount;
</code></pre>
<h3>16.9 根据活动ID查询活动详情</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token非校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/queryActiveDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/queryActiveDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>id</td><td>是</td><td>Long</td><td>122071</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>activityDetail</td><td>是</td><td>活动详情</td><td>活动详情</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>currentTime</td><td>是</td><td>Long</td><td>当前时间毫秒数</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>familyName</td><td>是</td><td>String</td><td>家族名称</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>objectID</td><td>是</td><td>Long</td><td>歌房外部号、liveID</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>applyRecord</h5>
<pre><code>	private Long id;	//活动唯一标识
    private Long familyId;//家族ID
    private Long userId;//申请人家族ID
    private String activityName;
    private String activityTheme;//活动主题
    private Integer activityDate;
    private Date submitTime;//活动提交时间
    private Date activityStartTime;//活动开始时间
    private Date activityEndTime;//活动结束时间
    private String activityType;//活动类型
    private String activityPlace;//活动地点,0直播间，1歌房
    private Long activityPlaceId;//直播间Id/歌房Id
    private String activityPublicityWords;//活动宣传语
    private String activityRules;//活动规则
    private String activityProgram;//活动节目单
    private String publicityVideo;//宣传视频
    private String activityCover;//活动封面
    private Short auditState;//0表示审核中,1表示审核通过,2表示审核未通过
    private String auditReson;//审核理由
    private String reviewLink; // 回顾链接 不是-1时才是链接
</code></pre>
<h3>16.10 怦然心动直播间查询数据</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/initPalAnchor.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/initPalAnchor.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播ID</td><td>anchorID</td><td>是</td><td>Long</td><td>900005085</td><td>主播ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>myRank</td><td>是</td><td>Long</td><td>当前排名</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>diffTicket</td><td>是</td><td>Long</td><td>与前一名差值</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>detLampNum</td><td>否</td><td>Integer</td><td>爆灯次数</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>detSurplus</td><td>是</td><td>Long</td><td>剩余经验值</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>16.11 怦然心动往日之星</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token非校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/queryPalStar.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/queryPalStar.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>palType</td><td>是</td><td>Long</td><td>1</td><td>1:主播榜;2:助力榜</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>palStarList</td><td>是</td><td>集合</td><td>明星集合</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>PalStarSpaceUser</h5>
<pre><code>	private Integer date;//日期 yyyyMMdd
    private Long userID;
    private String nickname;
    private String photo1;
    private Long moneyCount;//心动值/助力值
    private Long liveID;
</code></pre>
<h3>16.12 怦然心动榜单</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token非校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/queryPalAnchorInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/queryPalAnchorInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播类型</td><td>palType</td><td>是</td><td>Long</td><td>1</td><td>1:主播榜;2:助力榜</td></tr><tr><td>榜单类型类型</td><td>dateType</td><td>是</td><td>Long</td><td>1</td><td>1:昨日帮;:2今天榜;3:总榜</td></tr><tr><td>当前页</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>&nbsp;</td></tr><tr><td>查询多少条</td><td>viewNumber</td><td>是</td><td>Long</td><td>1</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>palList</td><td>是</td><td>对象</td><td>榜单对象</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>PalInfo</h5>
<pre><code>	private PalSpaceUser yesterAnchorStar; // 心动之星
    private PalSpaceUser yesterGuardStar; // 助力之星
    private PalSpaceUser myPalInfo;	//我的榜单
    private List&lt;PalSpaceUser&gt; palList;	// 榜单数据
</code></pre>
<h5>PalSpaceUser</h5>
<pre><code>	private Long userID;
    private String nickname;
    private String photo1;
    private Long moneyCount;//心动值/助力值
    private Long liveID;
</code></pre>
<h3>16.13 兴趣列表</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token非校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getInterestDataList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getInterestDataList.htm</a>
URL地址示例：<a href='https://music.51vv.com/sodnew/activity/city/getInterestDataList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getInterestDataList.htm?parameter=</a>{&quot;curPage&quot;:1,&quot;viewNumber&quot;:20}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>当前页</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>&nbsp;</td></tr><tr><td>查询多少条</td><td>viewNumber</td><td>是</td><td>Long</td><td>20</td><td>默认20条</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>对象</td><td>兴趣对象 InterestResult</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>InterestResult</h5>
<pre><code>	private List&lt;InterestData&gt; dataList; //兴趣集合
    private Boolean hasNext = false; // true:有下一页;false:无下一页
</code></pre>
<h5>InterestData</h5>
<pre><code>	private InterestAvInfo avInfo;//作品信息
    private LiveInfo liveInfo;//直播信息
    private CityUser user;//用户信息
    private Long time;//时间(毫秒)
</code></pre>
<h5>InterestAvInfo</h5>
<pre><code>	private Long avID;//音视频ID
    private String description;作品描述
    private String cover;//作品封面
    private String name;//作品名称
    private Short fileType;// 作品类型 1 原创 2 翻唱 3 伴奏 4 视频
    private date publishDate;// 发布时间
    private Integer playTimes;// 试听次数
    private Integer praiseTimes;// 点赞次数
    private Integer commentTimes;// 评论次数
    private Integer shareTimes;// 分享次数
    private Short exFileType;//0 独唱 1 合唱 2 半成品
    private Long semiUserID;           //发起合唱用户ID
    private Short semiUserAuthType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
    private String semiUserPhoto;           //发起合唱用户ID
    private String semiUserNickName;           //发起合唱用户昵称
    private Integer chorusNum;//合唱次数
    private Short zpSource;//&#39;作品来源 0 翻唱曲库 1 清唱 2 本地歌曲&#39;
    private Long giftAmount;//礼物数量
    private String algor_name;//算法名称
    private Short praisStatus;//0 未点赞  1 已点赞
    private Integer flowerAmount;//鲜花数量
    private String createTimeByFormat;//时间格式
</code></pre>
<h5>LiveInfo</h5>
<pre><code>	private Long liveID;//直播ID
    private String description;//直播主题
    private String liveCover;//直播封面 已包含coverImgUrl 或photo1
    private Long onlineCount;// 直播间人数
    private Short state;// 状态.0 直播未开始  1 直播中   2 直播关闭  3 回看中   4   删除   5 回看生成中   6 回看生成失败
    private String algor_name;//算法名称
    private String createTimeByFormat;//时间格式
    private Integer liveType; //1视频，2音频
    private String backgroundImgUrl;//背景图
</code></pre>
<h5>CityUser</h5>
<pre><code>	private String userID;
    private String nickname;//昵称
    private String photo1;// 头像
    private List vip;// 201:会员
    private Long level_wealth; //财富等级
    private String gender;//性别 F:女 M:男
    private Short authType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
    private String user_tags;//用户标签
</code></pre>
<h3>16.14 猜你喜欢</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token非校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/activity/city/getYouLikeList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getYouLikeList.htm</a>
URL地址示例：<a href='https://music.51vv.com/sodnew/activity/city/getYouLikeList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/city/getYouLikeList.htm?parameter=</a>{&quot;avID&quot;:9994894}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>9994894</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>对象</td><td>兴趣对象 InterestResult</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>InterestResult</h5>
<pre><code>	private List&lt;InterestData&gt; dataList; //兴趣集合
    private Boolean hasNext = false; // true:有下一页;false:无下一页
</code></pre>
<h5>InterestData</h5>
<pre><code>	private InterestAvInfo avInfo;//作品信息
    private CityUser user;//用户信息
</code></pre>
<h5>InterestAvInfo</h5>
<pre><code>	private Long avID;//音视频ID
    private String description;作品描述
    private String cover;//作品封面
    private String name;//作品名称
    private Short fileType;// 作品类型 1 原创 2 翻唱 3 伴奏 4 视频
    private date publishDate;// 发布时间
    private Integer playTimes;// 试听次数
    private Integer praiseTimes;// 点赞次数
    private Integer commentTimes;// 评论次数
    private Integer shareTimes;// 分享次数
    private Short exFileType;//0 独唱 1 合唱 2 半成品
    private Long semiUserID;           //发起合唱用户ID
    private Short semiUserAuthType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
    private String semiUserPhoto;           //发起合唱用户ID
    private String semiUserNickName;           //发起合唱用户昵称
    private Integer chorusNum;//合唱次数
    private Short zpSource;//&#39;作品来源 0 翻唱曲库 1 清唱 2 本地歌曲&#39;
    private Long giftAmount;//礼物数量
    private String algor_name;//算法名称
</code></pre>
<h5>CityUser</h5>
<pre><code>	private String userID;
    private String nickname;//昵称
    private String photo1;// 头像
    private List vip;// 201:会员
    private Long level_wealth; //财富等级
    private String gender;//性别 F:女 M:男
    private Short authType;//认证类型 0普通用户  1优质用户（原明星） 2独立音乐人 3认证歌手
    private String user_tags;//用户标签
</code></pre>
<h3>16.15 查询主播甜蜜排名</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/queryMyHoneyRankInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/queryMyHoneyRankInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播ID</td><td>anchorID</td><td>是</td><td>Long</td><td>900005085</td><td>主播ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>isEnd</td><td>是</td><td>Integer</td><td>活动状态</td><td>0:未开始 1:进行中 2:已结束</td></tr><tr><td>返回结果</td><td>currentLevel</td><td>否</td><td>String</td><td>当前级别</td><td>0:甜蜜大作战 1:爱你久久久 2:我一辈子爱你 3:一生一世我爱你 4:生生世世我爱你</td></tr><tr><td>返回结果</td><td>rank</td><td>否</td><td>Integer</td><td>甜蜜榜排名</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>honeyNum</td><td>否</td><td>String</td><td>女神值</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>16.16 查询甜蜜蜜榜单</h3>
<h5>接口作者：李志勇</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/queryHoneyBillboard.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/queryHoneyBillboard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>榜单类型</td><td>type</td><td>是</td><td>Integer</td><td>1</td><td>1：甜蜜榜；2：贡献榜</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>billboardList</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>BillboardInfo</h5>
<pre><code>	private MyHoneyInfo myHoneyInfo; 			//当前人员信息及排名
    private List&lt;HoneyBillboard&gt; honeybillboardList;		//女王榜单
</code></pre>
<h5>MyBillInfo</h5>
<pre><code>	private Long userID;
    private String nickname;
	private String photo1;
	private Long honeyNum;//甜蜜值
	private Integer honeyRank;//甜蜜排名
	private Long guardNum;//骑士值
	private Integer guardRank;//骑士排名
</code></pre>
<h5>HoneyBillboard</h5>
<pre><code>	private Long honeyUserID; //甜蜜userID
    private String honeyNickname;//甜蜜昵称
	private String honeyPhoto1;//甜蜜头像
	private Long honeyNum;//甜蜜值
	private Long liveID;//直播ID
	private Long guardUserID; //贡献userID
    private String guardNickname;//贡献昵称
	private String guardPhoto1;//贡献头像
	private Long guardNum;//贡献值
</code></pre>
<h3>17.1 我的乐币收支列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/detail/detail/diamondUseList.htm?startTime=2019-01-07' target='_blank' class='url'>https://music.51vv.com/detail/detail/diamondUseList.htm?startTime=2019-01-07</a> 16:30:00&amp;endTime=2019-02-27 16:30:00&amp;type=0&amp;curPage=1&amp;viewNumber=10</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>查询区间开始时间</td><td>startTime</td><td>是</td><td>String</td><td>2019-01-07 16:30</td><td>查询区间开始时间</td></tr><tr><td>查询区间结束时间</td><td>endTime</td><td>是</td><td>String</td><td>2019-01-07 16:30</td><td>查询区间结束时间</td></tr><tr><td>查询内容的类型</td><td>type</td><td>是</td><td>int</td><td>0</td><td>查询内容的类型,0是全部，1是充值，2是送礼，3是音符兑换乐币，4是活动奖励，5是家族发放</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001，参数错误</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>乐币收支集合</td><td>mapList</td><td>是</td><td>List</td><td>mapList</td><td>乐币收支集合</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;userID&quot;: 900002773,
            &quot;changeCount&quot;: 100,//变化的个数
            &quot;logID&quot;: 36513347,//这条记录的ID
            &quot;detailDesc&quot;: &quot;音符兑换乐币&quot;,
            &quot;logType&quot;: 3,//记录类型
            &quot;diamondCount&quot;: 94056869,//剩余乐币的总数
            &quot;logCreateTime&quot;: 1551248501000
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>17.2 我的音符收支列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/detail/detail/ticketUseList.htm?startTime=2019-01-07' target='_blank' class='url'>https://music.51vv.com/detail/detail/ticketUseList.htm?startTime=2019-01-07</a> 16:30:00&amp;endTime=2019-02-27 16:30:00&amp;type=0&amp;curPage=1&amp;viewNumber=10</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>查询开始时间</td><td>startTime</td><td>是</td><td>String</td><td>2019-01-07 16:30</td><td>查询开始时间</td></tr><tr><td>查询结束时间</td><td>endTime</td><td>是</td><td>String</td><td>2019-01-07 16:30</td><td>查询结束时间</td></tr><tr><td>查询内容的类型</td><td>type</td><td>是</td><td>int</td><td>0</td><td>查询内容的类型,0是全部，1是收礼物，2是提现，3兑换乐币，4是音符返利，5是活动奖励</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001是user非法，10002是查询时间为空，10003是type非法</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>乐币收支集合</td><td>mapList</td><td>是</td><td>List</td><td>mapList</td><td>乐币收支集合</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;userID&quot;: 900002773,
            &quot;changeCount&quot;: -200,//变化的音符数
            &quot;logID&quot;: 2888749,//这条记录的ID
            &quot;detailDesc&quot;: &quot;兑换乐币&quot;,//变化描述
            &quot;logType&quot;: 51,//这条记录的类型
            &quot;diamondCount&quot;: 19955173,//剩余的音符总数
            &quot;logCreateTime&quot;: 1551248501000
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>17.3 我的乐币收支记录详情页</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/detail/detail/diamondUseInfo.htm?logID=123' target='_blank' class='url'>https://music.51vv.com/detail/detail/diamondUseInfo.htm?logID=123</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>这条记录的ID</td><td>logID</td><td>是</td><td>Long</td><td>123</td><td>这条记录的ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功 10001是user非法，10002是查询时间为空，10003是type非法</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>直播间名称</td><td>liveName</td><td>是</td><td>String</td><td>某某的直播间</td><td>直播间名称</td></tr><tr><td>变化的个数</td><td>changeCount</td><td>是</td><td>Long</td><td>5000</td><td>变化的个数</td></tr><tr><td>详情信息描述</td><td>infoDesc</td><td>是</td><td>String</td><td>送礼</td><td>详情信息描述</td></tr><tr><td>歌房名称</td><td>roomName</td><td>是</td><td>String</td><td>某某的歌房</td><td>歌房名称</td></tr><tr><td>家族名称</td><td>familyName</td><td>是</td><td>String</td><td>某某的家族</td><td>家族名称</td></tr><tr><td>送的礼物名称</td><td>giftName</td><td>是</td><td>String</td><td>5个小黄瓜</td><td>送的礼物名称</td></tr><tr><td>收礼人的名称</td><td>receiverName</td><td>是</td><td>String</td><td>某某</td><td>收礼人的名称</td></tr><tr><td>购买道具的名称</td><td>packName</td><td>是</td><td>String</td><td>钻石卡</td><td>购买道具的名称</td></tr><tr><td>剩余乐币总数</td><td>diamondCount</td><td>是</td><td>Long</td><td>乐币数</td><td>剩余乐币总数</td></tr><tr><td>创建时间</td><td>logCreateTime</td><td>是</td><td>Timestamp</td><td>1551248512000</td><td>创建时间的毫秒值</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;liveName&quot;: &quot;&quot;,
    &quot;changeCount&quot;: 5000,
    &quot;retCode&quot;: 1000,
    &quot;infoDesc&quot;: &quot;5000音符兑换2500乐币&quot;,
    &quot;roomName&quot;: &quot;&quot;,
    &quot;spaceAvName&quot;: &quot;&quot;,
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;familyName&quot;: &quot;&quot;,
    &quot;giftName&quot;: &quot;&quot;,
    &quot;receiverName&quot;: &quot;&quot;,
    &quot;packName&quot;: &quot;&quot;,
    &quot;diamondCount&quot;: 94061869,
    &quot;logCreateTime&quot;: 1551248512000
}
</code></pre>
<h3>17.4 我的音符收支记录详情页</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/detail/detail/ticketUseInfo.htm?logID=123' target='_blank' class='url'>https://music.51vv.com/detail/detail/ticketUseInfo.htm?logID=123</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>这条记录的ID</td><td>logID</td><td>是</td><td>Long</td><td>123</td><td>这条记录的ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功 10001是user非法，10002是查询时间为空，10003是type非法</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr><tr><td>直播间名称</td><td>liveName</td><td>是</td><td>String</td><td>某某的直播间</td><td>直播间名称</td></tr><tr><td>变化的个数</td><td>changeCount</td><td>是</td><td>Long</td><td>5000</td><td>变化的个数</td></tr><tr><td>详情信息描述</td><td>infoDesc</td><td>是</td><td>String</td><td>送礼</td><td>详情信息描述</td></tr><tr><td>歌房名称</td><td>roomName</td><td>是</td><td>String</td><td>某某的歌房</td><td>歌房名称</td></tr><tr><td>家族名称</td><td>familyName</td><td>是</td><td>String</td><td>某某的家族</td><td>家族名称</td></tr><tr><td>送的礼物名称</td><td>giftName</td><td>是</td><td>String</td><td>5个小黄瓜</td><td>送的礼物名称</td></tr><tr><td>送礼人的名称</td><td>senderName</td><td>是</td><td>String</td><td>某某</td><td>送礼人的名称</td></tr><tr><td>购买道具的名称</td><td>packName</td><td>是</td><td>String</td><td>钻石卡</td><td>购买道具的名称</td></tr><tr><td>剩余乐币总数</td><td>diamondCount</td><td>是</td><td>Long</td><td>乐币数</td><td>剩余乐币总数</td></tr><tr><td>作品的名称</td><td>spaceAvName</td><td>是</td><td>String</td><td>某某歌曲</td><td>作品的名称</td></tr><tr><td>创建时间</td><td>logCreateTime</td><td>是</td><td>Timestamp</td><td>1551248512000</td><td>创建时间的毫秒值</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;changeCount&quot;: 1688,
    &quot;liveName&quot;: &quot;&quot;,
    &quot;infoDesc&quot;: &quot;收礼&quot;,
    &quot;spaceAvName&quot;: &quot;&quot;,
    &quot;familyName&quot;: &quot;&quot;,
    &quot;retCode&quot;: 1000,
    &quot;senderName&quot;: &quot;Tina&quot;,
    &quot;roomName&quot;: &quot;CY_大西瓜的歌房&quot;,
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;giftName&quot;: &quot;&quot;,
    &quot;packName&quot;: &quot;&quot;,
    &quot;logCreateTime&quot;: 1551341189000,
    &quot;diamondCount&quot;: 19962833
}
</code></pre>
<h3>17.5 删除我的乐币收支记录</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/detail/detail/updateDiamondLog.htm?logID=2890355' target='_blank' class='url'>https://music.51vv.com/detail/detail/updateDiamondLog.htm?logID=2890355</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>这条记录的ID</td><td>logID</td><td>是</td><td>Long</td><td>123</td><td>这条记录的ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功， 10001是user非法，10002是记录不存在</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>17.6 删除我的音符收支记录</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/detail/detail/updateTicketLog.htm?logID=2890355' target='_blank' class='url'>https://music.51vv.com/detail/detail/updateTicketLog.htm?logID=2890355</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>这条记录的ID</td><td>logID</td><td>是</td><td>Long</td><td>123</td><td>这条记录的ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功， 10001是user非法，10002是记录不存在</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>系统处理成功</td><td>系统处理成功/操作失败</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>18.1 删除家族标签</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/updateFamilyTags.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/updateFamilyTags.htm?parameter=</a>{tagType:1,familyID:168}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>tag类型</td><td>tagType</td><td>是</td><td>Integer</td><td>123</td><td>tag类型:1是tag1,2是tag2</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>168</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功， 10002是user非法，10003是familyID非法</td></tr><tr><td>返回结果描述</td><td>result</td><td>是</td><td>int</td><td>系统处理成功</td><td>系统处理成功/操作失败.1是成功，非1是失败。</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;retCode&quot;: 1000,
    &quot;result&quot;: 1
}
</code></pre>
<h3>18.2 家族长访问新人空间调用的接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/addFamilyVisit.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/addFamilyVisit.htm?parameter=</a>{targetUserID:900009929}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>目标用户ID</td><td>targetUserID</td><td>是</td><td>Long</td><td>900009929</td><td>目标用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功， 10002是user非法，10003是familyID非法</td></tr><tr><td>返回结果描述</td><td>result</td><td>是</td><td>int</td><td>系统处理成功</td><td>系统处理成功/操作失败.1是成功，非1是失败。</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;retCode&quot;: 1000,
    &quot;result&quot;: 1
}
</code></pre>
<h3>18.3 家族拉新列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/familyPullNewList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/familyPullNewList.htm?parameter=</a>{curPage:1,viewNumber:10}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>20</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000是成功， 10002是user非法</td></tr><tr><td>返回结果描述</td><td>result</td><td>是</td><td>List</td><td>SpaceUser的集合</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;retCode&quot;: 1000,
    &quot;result&quot;: []
}
</code></pre>
<h3>18.4 是否显示家族人气的入口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/isShowPopularCount.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/isShowPopularCount.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>1显示，0不显示</td></tr></tbody>
</table></figure>
<h3>19.1 创建作品集</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/createWorkCollection.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/createWorkCollection.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>封面图片</td><td>coverUrl</td><td>是</td><td>String</td><td>&nbsp;</td><td>作品集封面图片</td></tr><tr><td>名称</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>作品集的名称</td></tr><tr><td>描述</td><td>description</td><td>否</td><td>String</td><td>&nbsp;</td><td>作品集的描述</td></tr><tr><td>标签集合</td><td>tagList</td><td>否</td><td>list</td><td>tagList:[&quot;wwwwsdad&quot;,&quot;sda&quot;]</td><td>多个标签集合</td></tr><tr><td>作品列表</td><td>works</td><td>否</td><td>String</td><td>9000154,922221</td><td>多个AVID，最多100个,用英文逗号隔开</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>&nbsp;</td><td>1000 成功 1001参数错误 1005操作失败,1921标签数量超限,作品集数量超限</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集id</td></tr></tbody>
</table></figure>
<h3>19.2 修改作品集信息</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/updateWorkCollection.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/updateWorkCollection.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集的id</td></tr><tr><td>封面图片</td><td>coverUrl</td><td>否</td><td>String</td><td>&nbsp;</td><td>作品集封面图片</td></tr><tr><td>名称</td><td>name</td><td>否</td><td>String</td><td>&nbsp;</td><td>作品集的名称</td></tr><tr><td>描述</td><td>description</td><td>否</td><td>String</td><td>&nbsp;</td><td>作品集的描述</td></tr><tr><td>标签集合</td><td>tagList</td><td>否</td><td>list</td><td>tagList:[&quot;wwwwsdad&quot;,&quot;sda&quot;]</td><td>多个标签集合</td></tr><tr><td>作品列表</td><td>works</td><td>否</td><td>String</td><td>9000154,922221</td><td>多个AVID，最多100个,用英文逗号隔开 不修改不上传</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.3 删除作品集</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/deleteWorkCollection.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/deleteWorkCollection.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集的id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.4 查看作品集</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/queryWorkCollection.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/queryWorkCollection.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集的id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回作品集详情json</td><td>workCollectionInfo</td><td>是</td><td>Object</td><td>&nbsp;</td><td>返回json格式对象</td></tr></tbody>
</table></figure>
<p>coverUrl为空时取https://music.51vvcom/user/cfg/getCfgInfo.htm中allIcons的workCollection_001为默认背景图
orkCollection_002为默认封面</p>
<p><span id="jumpWorkCollection"></span></p>
<h5>workCollectionInfo</h5>
<pre><code>private Long collectionId;//作品集Id
private Long creator;	//作品集创建者Id
private String name;		//名称
private String description;	//简介
private String coverUrl;		//图片Url
private List&lt;Tag&gt; tags;  	//标签集合
private Integer zpCount;		//作品数量
private Integer playTimes;	//播放次数
private Integer commentTimes; //评论次数
private Integer collectTimes; //收藏次数
private Integer shareTimes;	//分享次数
private Integer praiseTimes;	//点赞次数
private String nickname;    //专辑创建者名称
private String photo1;      //图片1
private String photo2;      //图片2
private String photo3;      //图片3
private Integer praisedState; //0未点赞, 1已点赞（未读） 2已点赞（已读）
private Integer collectdState; //0 未收藏, 1 收藏
private Short status;        //作品集状态 如果等于0，下次拉取收藏列表就拉不到了 0无效、已删除 1有效
private Short blacklistStatus; //拉黑状态，如果等于1，下次拉取收藏列表就拉不到了 0否 1是
private Integer zjCount;       //专辑数量 
</code></pre>
<h5>Tag</h5>
<pre><code>	private Long id;	//标签id
	private String tag;//标签描述
</code></pre>
<h3>19.5 查看最近创建的作品集</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/queryWorkCollectionLastCreate.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/queryWorkCollectionLastCreate.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>被查看者用户ID</td><td>creator</td><td>是</td><td>Long</td><td>&nbsp;</td><td>被查看者用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回作品集详情json</td><td>workCollectionInfo</td><td>是</td><td>Object</td><td>&nbsp;</td><td>返回json格式对象</td></tr></tbody>
</table></figure>
<h5>作品集模型 WorkCollection</h5>
<p><a href='#jumpWorkCollection'>跳转</a></p>
<h3>19.6 查看所有标签</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/queryWorkCollectionAllTags.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/queryWorkCollectionAllTags.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回标签json</td><td>tagList</td><td>是</td><td>Object</td><td>&nbsp;</td><td>返回json格式对象，默认标签</td></tr><tr><td>返回标签json</td><td>customTagList</td><td>是</td><td>Object</td><td>自定义标签集合,有值就返</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>
{
    &quot;retCode&quot;: 1000,
    &quot;customTagList&quot;: [
        
            &quot;creator&quot;: 7849100, 创建人
            &quot;id&quot;: 1,            自定义标签id
            &quot;tag&quot;: &quot;haloe&quot;,         自定义标签描述
        }
    ],
    &quot;tagList&quot;: [            
        &quot;华语&quot;,
        &quot;粤语&quot;,
        &quot;英语&quot;,
        &quot;韩语&quot;,
        &quot;日语&quot;,
        &quot;闽南语&quot;,
        &quot;流行&quot;,
        &quot;民谣&quot;,
        &quot;摇滚&quot;,
        &quot;二次元&quot;,
        &quot;R&amp;B&quot;,
        &quot;嘻哈&quot;,
        &quot;戏曲&quot;,
        &quot;朗诵&quot;,
        &quot;古风&quot;,
        &quot;民族&quot;,
        &quot;美声&quot;,
        &quot;爵士&quot;
    ],
    &quot;customTagCount&quot;: 1
}
</code></pre>
<p>&nbsp;</p>
<h3>19.8 从作品集删除作品</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/delWorksFromWorkCollection.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/delWorksFromWorkCollection.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>删除作品的作品集</td></tr><tr><td>作品id</td><td>works</td><td>是</td><td>Long</td><td>9000154</td><td>作品id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.9 查看作品集列表</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/queryWorkCollectionList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/queryWorkCollectionList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集拥有者的id</td><td>creator</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集拥有者的id</td></tr><tr><td>当前作品集id</td><td>collectionId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>查看其他作品集列表时传这个参数，否则不传。</td></tr><tr><td>页数</td><td>curPage</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>页数</td></tr><tr><td>每页条数</td><td>viewNumber</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>每页条数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回作品集列表</td><td>workCollectionList</td><td>是</td><td>List</td><td>&nbsp;</td><td>返回json格式对象</td></tr></tbody>
</table></figure>
<h5>作品集模型 WorkCollection</h5>
<p><a href='#jumpWorkCollection'>跳转</a></p>
<h3>19.10 批量查询作品是否已添加</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/checkWorkState.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/checkWorkState.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>需要添加的作品集id</td></tr><tr><td>作品列表</td><td>works</td><td>是</td><td>String</td><td>9000154,922221</td><td>多个作品列表,逗号隔开</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回已添加作品集合</td><td>addWorks</td><td>是</td><td>String</td><td>&nbsp;</td><td>已添加的多个作品集合</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>19.12 评论作品集</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/comment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/comment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr><tr><td>评论内容</td><td>content</td><td>是</td><td>String</td><td>&nbsp;</td><td>评论内容</td></tr><tr><td>父评论Id</td><td>parentId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>父评论Id</td></tr><tr><td>回复消息类型</td><td>replyType</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>回复消息类型 0:普通  1:送花(暂无)  2:点赞  3:分享(暂无)，4:礼物(暂无) 在@我的中回复  (这里只有0、2，默认0)</td></tr><tr><td>回复对象</td><td>toUserID</td><td>否</td><td>Long</td><td>&nbsp;</td><td>回复对象（只有当replyType=2的时候，需要填写toUserID）</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败 <strong>1040无操作权限</strong></td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回刚发表的评论</td><td>comment</td><td>是</td><td>SpaceCommentResult</td><td>&nbsp;</td><td>返回json格式对象</td></tr></tbody>
</table></figure>
<h5>评论模型 SpaceCommentResult</h5>
<p><a href='#jumpSpaceCommentResult'>跳转</a></p>
<h3>19.13 删除作品集评论</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/deleteComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/deleteComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>评论Id</td><td>commentId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.14 根据作品集Id获取评论列表</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/getCommentsByCollectionId.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/getCommentsByCollectionId.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr><tr><td>页数</td><td>curPage</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>页数</td></tr><tr><td>每页条数</td><td>viewNumber</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>每页条数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回评论列表</td><td>commentList</td><td>是</td><td>List</td><td>&nbsp;</td><td>返回json格式对象</td></tr></tbody>
</table></figure>
<p><span id="jumpSpaceCommentResult"></span></p>
<h5>评论模型 SpaceCommentResult</h5>
<pre><code>private Integer commentID;              //评论ID
private Integer type;                   //类型 0作品 1分享 2作品集
private String content;                 //评论内容
private String createTime;              //发表时间
private String createTimeFormat;        //格式化后的发表时间
private Integer parentID;               //父评论ID
private Integer replyType;              //回复类型 0普通 1送花 2点赞 3分享
private Integer flowerAmount;           //回复送花的鲜花数量

private Integer praiseNum;              //点赞数量 
private Boolean praise;                 //评论是否点赞 true是 false否 

private Long userID;                    //评论人ID
private String photo1;                  //头像
private String nickname;                //昵称
private Integer authType;               //认证类型
private Integer authState;              //认证状态
private String authInfo;                //认证信息
private Date memberExpiretime;          //会员过期时间
private Short vip;                      //会员状态 1是 0否

private Long byReplyUserID;             //被评论人ID
private String byReplyNicename;         //被评论人昵称
private Date byReplyMemberExpiretime;   //被评论人会员过期时间
private Short byReplyVip;               //被评论人会员状态 1是 0否

private String parentContent;           //父评论内容(预留)
</code></pre>
<h3>19.15 作品集站内分享</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/share.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/share.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr><tr><td>分享内容</td><td>content</td><td>是</td><td>String</td><td>&nbsp;</td><td>分享内容</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败 <strong>1040无操作权限 1201分享频率限制</strong></td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.16 作品集站外分享回调</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/shareToThirdCallback.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/shareToThirdCallback.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr><tr><td>分享渠道</td><td>channel</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>分享渠道 0未知 1微信 2微信朋友圈 3QQ 4QQ空间 5新浪微博 6腾讯微博</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.17 作品集播放回调</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/playCallback.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/playCallback.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.18 收藏和取消收藏作品集</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/collect.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/collect.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>类型 0取消收藏 1收藏</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败 <strong>1205收藏到达上限</strong></td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.19 查看收藏的作品集</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/getCollectCollectionsByUserID.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/getCollectCollectionsByUserID.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户Id</td><td>userId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回作品集列表</td><td>workCollectionList</td><td>是</td><td>List</td><td>&nbsp;</td><td>返回json格式对象</td></tr></tbody>
</table></figure>
<h5>作品集模型 WorkCollection</h5>
<p><a href='#jumpWorkCollection'>跳转</a></p>
<h3>19.20 点赞和取消点赞作品集</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/praise.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/praise.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集Id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集Id</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>类型 0取消点赞 1点赞</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.21 点赞和取消点赞作品集评论</h3>
<h5>接口作者 温志广</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/praiseComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/praiseComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>评论Id</td><td>commentId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>评论Id</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>类型 0取消点赞 1点赞</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.22 添加自定义标签</h3>
<h5>接口作者 胡明政</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/addCustomTag.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/addCustomTag.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>标签名称</td><td>tag</td><td>是</td><td>String</td><td>&nbsp;</td><td>标签名称</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败,1921自定义标签超限</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>自定义标签id</td><td>tagId</td><td>否</td><td>Long</td><td>处理成功</td><td>标签id</td></tr><tr><td>自定义标签名称</td><td>tag</td><td>否</td><td>String</td><td>处理成功</td><td>标签名称</td></tr></tbody>
</table></figure>
<h3>19.23 删除自定义标签</h3>
<h5>接口作者 胡明政</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/delCustomTag.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/delCustomTag.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>标签id</td><td>tagId</td><td>是</td><td>String</td><td>&nbsp;</td><td>标签id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>19.24 获取作品集内作品列表</h3>
<h5>接口作者 胡明政</h5>
<h5>接口链接   </h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/work/collection/getWorksByCollectionId.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/work/collection/getWorksByCollectionId.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品集id</td><td>collectionId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>作品集的id</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>100</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>spaceAvList</td><td>是</td><td>集合</td><td>作品列表</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>作品模型 SpaceAvResult</h5>
<pre><code>	private Integer AVID;                //作品ID
	private Long userID;                 //用户ID
	private String name;                 //作品名称
	private String frontCoverUrl;        //封面图片Url
	private String description;          //描述
	private Integer playTimes;           //播放次数
	private Integer praiseTimes;         //点赞次数
	private Integer shareTimes;          //分享次数
	private Integer commentTimes;        //评论次数
	private Timestamp createTime;        //创建时间
	private Integer fileType;            //文件类型 4视频 其他音频
	private String fileURL;              //文件地址
	private Integer kscSongID;	         //曲库ID
	private String thumbUrl;             //缩略图
	private Float duration;              //时长
	private Float bitrate;               //码流
	private String fileDomain;           //上传域
	private Integer zpSource;            //作品来源 0翻唱曲库 1清唱 2本地歌曲
	private Integer flowerAmount;        //鲜花数量
	private Long giftAmount;             //礼物数量
	private Short goodVoice;             //好声音标记 1是 0否
	private String cover;                //作品封面
    private Short status;                //作品状态 //状态 0 初始 2 审核通过 4 删除或者审核不通过
    private String singerName;       	//歌手名
	private String nickName;             //用户昵称
	private String userPhoto;            //用户头像
	private String gender;               //用户性别
	private Integer authType;            //用户认证类型
	private Integer authState;           //用户认证状态
	private String authInfo;             //用户认证信息
	private Date memberExpiretime;
	private Long level_singer;           //用户歌手等级

	private String semiNickName;         //发起合唱用户昵称
	private String semiUserPhoto;        //发起合唱用户头像
	private String semiGender;           //发起合唱用户性别
	private Integer semiAuthType;        //发起合唱用户认证类型
	private Integer semiAuthState;       //发起合唱用户认证状态
	private String semiAuthInfo;         //发起合唱用户认证信息
	private Date semiMemberExpiretime;
	private Long semi_level_singer;      //发起合唱用户歌手等级
	private Short blacklistStatus; // 0否 1是
	private Integer isPraised;//是否点过赞（作废）
</code></pre>
<h3>20.1 查询用户余额</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getUserAccount.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getUserAccount.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>银行卡气泡</td><td>bankCardBubbleNum</td><td>是</td><td>int</td><td>0</td><td>&nbsp;</td></tr><tr><td>微信气泡</td><td>wxBubbleNum</td><td>是</td><td>int</td><td>0</td><td>&nbsp;</td></tr><tr><td>用户音符余额</td><td>pTicketCount</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户可提现金额</td><td>pGetMoney</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>是否显示微信提现到限额</td><td>pShowLimit</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>是否显示银行卡提现</td><td>pShowBank</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.2 是否允许提现到微信（点击微信提现调用）</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/isMoneyToWeiXin.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/isMoneyToWeiXin.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>微信提现状态</td><td>pDrawState</td><td>是</td><td>int</td><td>1</td><td>1 可以提现 2 提现信息未绑定 3 不可以提现</td></tr><tr><td>微信是否绑定</td><td>pDrawWxBind</td><td>是</td><td>int</td><td>&nbsp;</td><td>(pDrawState=2才有意义)</td></tr><tr><td>领取人是否绑定</td><td>pDrawNameBind</td><td>是</td><td>int</td><td>&nbsp;</td><td>(pDrawState=2才有意义)</td></tr><tr><td>不可以提现原因</td><td>pDrawFailCode</td><td>是</td><td>int</td><td>&nbsp;</td><td>1 只可以银行卡提现 2 无会员 3 已经达到微信限额(pDrawState=3才有意义)</td></tr><tr><td>是否显示微信提现失败</td><td>pShowFail</td><td>是</td><td>int</td><td>&nbsp;</td><td>显示以后打开绑定弹层</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.3 获取用户音符提现提交页面数据</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getApplyMoneyToWeiXinHtmlInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getApplyMoneyToWeiXinHtmlInfo.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>绑定微信昵称</td><td>pWxNick</td><td>是</td><td>String</td><td>1</td><td>&nbsp;</td></tr><tr><td>绑定微信头像</td><td>pWxPhote</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>今日剩余可领取金额</td><td>pGetLeftMoney</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.4 提现申请</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/applyMoneyToWeiXin.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/applyMoneyToWeiXin.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>金额</td><td>amount</td><td>是</td><td>Number</td><td>100.00</td><td>单位元</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,13025:不可以微信提现,13013:已超出今日领取限额,13010:音符余额不足,13015:领取金额必须为整数且不少于10元,13011:账户锁定不可以兑换,13026:无会员,13006:用户没有绑定微信,13016:其他原因失败</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.5 是否允许银行卡提现(点击银行卡提现调用)</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/isMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/isMoneyToBankCard.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>银行卡提现状态</td><td>pDrawState</td><td>是</td><td>int</td><td>1</td><td>1 可以提现 2 提现信息未绑定 3 不可以提现</td></tr><tr><td>银行卡是否绑定</td><td>pDrawBankBind</td><td>是</td><td>int</td><td>&nbsp;</td><td>(pDrawState=2才有意义) 0是未绑定 1 待审核 2 审核通过 3 审核不通过</td></tr><tr><td>领取人是否绑定</td><td>pDrawNameBind</td><td>是</td><td>int</td><td>&nbsp;</td><td>(pDrawState=2才有意义)</td></tr><tr><td>不可以提现原因</td><td>pDrawFailCode</td><td>是</td><td>int</td><td>&nbsp;</td><td>1 微信提现额度未使用完 2 无会员 3 已经达到本月限额 4 银行卡异常 5 财务结算中(pDrawState=3才有意义)</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.6 获取银行卡提现手机验证码</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getBankCardVerificationCode.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getBankCardVerificationCode.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>手机号</td><td>mobile</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 -101:服务器ip错误,-102:服务器签名错误,-103:格式错误,101:次数受限制,-104:手机号码错误,107:次数受限制 超过一天的限制,</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.7 添加银行卡收益人</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/addAuthInfoBank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/addAuthInfoBank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>验证码</td><td>verifyCode</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>手机号</td><td>telephone</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证号</td><td>papersNumber</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户真实姓名</td><td>userRealName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>1 成功 0失败  -2验证码有误</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.8 添加银行卡信息</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/addBankCardInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/addBankCardInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>所属省</td><td>provinceName</td><td>否</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>所属市</td><td>cityName</td><td>否</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>银行名称</td><td>bankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>开户行</td><td>bankOpen</td><td>否</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>银行卡号</td><td>bankAccount</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证正面照片</td><td>papersNumberImg1</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证反面照片</td><td>papersNumberImg2</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>1 成功 0失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误、</td></tr></tbody>
</table></figure>
<h3>20.9 获取银行卡开户行银行</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getOpeningBank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getOpeningBank.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>所属省</td><td>provinceName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>所属市</td><td>cityName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>银行名称</td><td>bankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>开户行</td><td>branchBankList</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h4>branchBankList</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>所属省</td><td>provinceName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>所属市</td><td>cityName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>银行名称</td><td>bankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>开户行</td><td>branchBankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>20.10 获取银行卡信息状态</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getBankCardInfoState.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getBankCardInfoState.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>状态</td><td>state</td><td>是</td><td>int</td><td>&nbsp;</td><td>1 待审核 2 审核通过 3 审核不通过</td></tr><tr><td>审核信息</td><td>stateInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>待审核</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.11 获取用户银行卡提现提交页面数据</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getApplyMoneyToBankCardHtmlInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getApplyMoneyToBankCardHtmlInfo.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>绑定银行卡账户</td><td>pBankAccount</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>绑定银行卡开户人姓名</td><td>pUserName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>绑定银行卡开户银行</td><td>pBankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>今日剩余可领取金额</td><td>pGetLeftMoney</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.12 银行卡提现申请</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p> URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/applyMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/applyMoneyToBankCard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>金额</td><td>amount</td><td>是</td><td>Number</td><td>100.00</td><td>单位元</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>预计打款日期</td><td>pDrawDate</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,13027:微信提现额度未使用完,13013:已超出今日领取限额,13010:音符余额不足,13015:领取金额必须为整数且不少于10元,13011:账户锁定不可以兑换,13026:无会员,13028:未绑定银行卡信息,13029:财务结算中,13016:其他原因失败</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.13 取消银行卡提现</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/cancelMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/cancelMoneyToBankCard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>订单id</td><td>postID</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>撤销结果</td><td>pResult</td><td>是</td><td>Int</td><td>&nbsp;</td><td>1 成功，2 提现已出账无法撤销，3 提交不存在，255 其他原因提现失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.14 是否允许家族提现</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/isFamilyMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/isFamilyMoneyToBankCard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族id</td><td>familyID</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>提现状态</td><td>pDrawState</td><td>是</td><td>String</td><td>&nbsp;</td><td>1 可以提现 2 提现信息未绑定 3 不可以提现</td></tr><tr><td>不可以提现原因</td><td>pDrawFailCode</td><td>是</td><td>String</td><td>&nbsp;</td><td>2 无会员 3 已经达到本月限额 4 银行卡异常 5 财务结算中(pDrawState=3才有意义)</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.15 查询家族当前可提现余额</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getFamilyHowMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getFamilyHowMoneyToBankCard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族id</td><td>familyID</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>绑定银行卡账户</td><td>pBankAccount</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>绑定银行卡开户人姓名</td><td>pUserName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>绑定银行卡开户银行</td><td>pBankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>当月剩余可领取金额</td><td>pGetLeftMoney</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.16 家族银行卡提现申请</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/applyFamilyMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/applyFamilyMoneyToBankCard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族id</td><td>familyID</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr><tr><td>提现金额</td><td>getMoney</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>预计打款日期</td><td>pDrawDate</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,13030:家族ID或者用户ID数据有错误,13031:超出本月提现上限,13010:音符余额不足,13015:领取金额必须为整数且不少于10元,13011:账户锁定不可以兑换,13026:无会员,13028:未绑定银行卡信息,13029:财务结算中,13016:其他原因失败</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.17 取消家族银行卡提现</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/cancelFamilyMoneyToBankCard.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/cancelFamilyMoneyToBankCard.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>订单id</td><td>postID</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>撤销结果</td><td>pResult</td><td>是</td><td>Int</td><td>&nbsp;</td><td>1 成功，2 提现已出账无法撤销，3 提交不存在，255 其他原因提现失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.18 获取绑定微信信息</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getbindWeiXinInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getbindWeiXinInfo.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>微信头像</td><td>userWxImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>微信昵称</td><td>wxNickName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.19 添加微信收益人</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/addUserAuthInfoToWeiXin.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/addUserAuthInfoToWeiXin.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>身份证号</td><td>papersNumber</td><td>是</td><td>Long</td><td>100</td><td>&nbsp;</td></tr><tr><td>真实姓名</td><td>userRealName</td><td>是</td><td>String</td><td>100</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>结果</td><td>result</td><td>是</td><td>Int</td><td>&nbsp;</td><td>1 成功</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.20 查询领取人信息</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getUserAuthInfoBank.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getUserAuthInfoBank.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>手机号</td><td>telephone</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证号</td><td>papersNumber</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户真实姓名</td><td>userRealName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.21 查询绑定银行卡</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getUserDrawBankInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getUserDrawBankInfo.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userid</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>状态</td><td>state</td><td>是</td><td>String</td><td>&nbsp;</td><td>1 待审核 2 审核通过 3 审核不通过</td></tr><tr><td>所属省</td><td>provinceName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>所属市</td><td>cityName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>银行名称</td><td>bankName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>开户行</td><td>bankOpen</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>银行卡号</td><td>bankAccount</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证正面照片</td><td>papersNumberImg1</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>身份证反面照片</td><td>papersNumberImg2</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>审核信息</td><td>stateInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打款失败原因</td><td>msg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户真实名称</td><td>userRealName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.22 修改气泡弹出已完成</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/updateShowBubbleFinish.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/updateShowBubbleFinish.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>银行卡气泡</td><td>bankCardBubbleNum</td><td>是</td><td>int</td><td>0</td><td>&nbsp;</td></tr><tr><td>微信气泡</td><td>wxBubbleNum</td><td>是</td><td>int</td><td>0</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&gt;=1 成功</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.23 验证身份证号和真实姓名</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/checkNumberAndRealName.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/checkNumberAndRealName.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>身份证号</td><td>papersNumber</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户真实姓名</td><td>userRealName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>ret</td><td>是</td><td>String</td><td>&nbsp;</td><td>result 1 成功， 其他为错误 validateState 1  校验成功 其他为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.24 查询使用新提现还是老提现</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/getApplyMoneyNewOrOld.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/getApplyMoneyNewOrOld.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>String</td><td>&nbsp;</td><td>result <a href='https://music.51vv.com/wx/m/drawMoney/dist/html/index.html?nosharebtn=1' target='_blank' class='url'>https://music.51vv.com/wx/m/drawMoney/dist/html/index.html?nosharebtn=1</a> 新提现。老提现 null</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.25 银行卡提现失败回退音符</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/drawNewBankSetFail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/drawNewBankSetFail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>期号</td><td>postDate</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>失败原因</td><td>reason</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>pResult</td><td>是</td><td>Boolean</td><td>&nbsp;</td><td>true 成功 false 失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.26 银行卡成功设置状态</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/drawNewBankSetSuc.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/drawNewBankSetSuc.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>期号</td><td>postDate</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打款成功的信息</td><td>reason</td><td>是</td><td>String</td><td>&nbsp;</td><td>显示格式：5月7日打款工商银行尾号1011</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>pResult</td><td>是</td><td>Boolean</td><td>&nbsp;</td><td>true 成功 false 失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.27 添加用户协议日志</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/addUserAgreementLog.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/addUserAgreementLog.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>协议id</td><td>agreementID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>pResult</td><td>是</td><td>int</td><td>&nbsp;</td><td>1成功 retCode=1000时存在</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>20.28 通过用户id查询用户未同意的大额提现的协议</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/selectNoAgreementByUserID.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/selectNoAgreementByUserID.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>pResult</td><td>是</td><td>List</td><td>&nbsp;</td><td>为空表示没有要签署的协议</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h4>pResult信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>id</td><td>是</td><td>Long</td><td>&nbsp;</td><td>协议id</td></tr><tr><td>返回结果</td><td>agreementUrl</td><td>是</td><td>String</td><td>&nbsp;</td><td>协议页面地址</td></tr><tr><td>返回结果</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>名称</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>20.29 通过类型查询协议</h3>
<h5>接口作者 刘冰</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/trans/withdrawnew/selectAgreementByType.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/trans/withdrawnew/selectAgreementByType.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>pResult</td><td>是</td><td>List</td><td>&nbsp;</td><td>为空表示没有要签署的协议</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h4>pResult信息</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>id</td><td>是</td><td>Long</td><td>&nbsp;</td><td>协议id</td></tr><tr><td>返回结果</td><td>agreementUrl</td><td>是</td><td>String</td><td>&nbsp;</td><td>协议页面地址</td></tr><tr><td>返回结果</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>名称</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>21.1 K歌大赛，报名选择作品列表接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/selectSpaceAvList.htm' target='_blank' class='url'>https://music.51vv.com/act/song/selectSpaceAvList.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>spaceAvMapList</td><td>是</td><td>List</td><td>&nbsp;</td><td>可报名的作品列表</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>21.2 K歌大赛，作品状态接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/spaceAvInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/song/spaceAvInfo.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;cover&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/07/16/180716144818c269a57f6cdd42fd.jpg&quot;,
    &quot;spaceAvName&quot;: &quot;夜曲&quot;,
    &quot;avDesc&quot;: &quot;&quot;,				//作品状态描述
    &quot;nickName&quot;: &quot;CY_大西瓜&quot;,
    &quot;step&quot;: 0,
    &quot;state&quot;: 0,
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;,
    &quot;avID&quot;: 9996156,
    &quot;isShow&quot;: 1 				//作品状态框是否显示
}
</code></pre>
<h3>21.3 K歌大赛，用户投票接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/vote.htm' target='_blank' class='url'>https://music.51vv.com/act/song/vote.htm</a>？avID=XX&amp;clientType=XXX</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>投票端类型</td><td>clientType</td><td>是</td><td>Short</td><td>1</td><td>1手机 2小程序</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>1:投票成功，0投票失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>21.4 K歌大赛，搜索参赛作品vv号和作品编号接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/search.htm?searchId=XX' target='_blank' class='url'>https://music.51vv.com/act/song/search.htm?searchId=XX</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>VV号或者用户作品编号</td><td>searchId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>mapList</td><td>是</td><td>List</td><td>&nbsp;</td><td>用户作品信息</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;cover&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/			userPhoto/18/07/16/180716144818c269a57f6cdd42fd.jpg&quot;,
            &quot;spaceAvName&quot;: &quot;夜曲&quot;,
            &quot;nickName&quot;: &quot;CY_大西瓜&quot;,
            &quot;avNo&quot;: 4,				//用户作品编号
            &quot;avID&quot;: 9996156,		//用户作品ID
            &quot;userID&quot;: 900002773
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>21.5 K歌大赛，点击下一首歌曲接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/nextSong.htm' target='_blank' class='url'>https://music.51vv.com/act/song/nextSong.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avID</td><td>是</td><td>Long</td><td>12345</td><td>作品ID</td></tr><tr><td>返回结果</td><td>spaceAv</td><td>是</td><td>Object</td><td>&nbsp;</td><td>用户作品信息模型</td></tr><tr><td>返回结果</td><td>isEnd</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>评委是都全部评完作品，1全部评完，0未全部评完</td></tr><tr><td>返回结果</td><td>countStr</td><td>是</td><td>String</td><td>13/100</td><td>该评委共打分多少个作品</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>21.6 K歌大赛-查询该用户是否可报名</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/vaildKSongStatus.htm' target='_blank' class='url'>https://music.51vv.com/act/song/vaildKSongStatus.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>0:未报名,1:不在申请时间范围内,2:不在申请白名单之内,3：审核未通过,4:审核通过,5:报名中</td></tr></tbody>
</table></figure>
<h3>21.7 K歌大赛-报名接口</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/signKSong.htm' target='_blank' class='url'>https://music.51vv.com/act/song/signKSong.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>手机号</td><td>phone</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>0:报名成功,1:不在申请时间范围内,2:不在申请白名单之内,3:报名信息已存在</td></tr></tbody>
</table></figure>
<h3>21.8 K歌大赛-评委打分接口</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/scoreKSong.htm' target='_blank' class='url'>https://music.51vv.com/act/song/scoreKSong.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打分一</td><td>scoreOne</td><td>是</td><td>double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打分二</td><td>scoreTwo</td><td>是</td><td>double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打分三</td><td>scoreThree</td><td>是</td><td>double</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>0:打分成功,1:不在评委白名单之内,2:该评委已打分,3:该作品只能有5位评委评分</td></tr></tbody>
</table></figure>
<h3>21.9 作品广告位接口</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/KSongBanner.htm' target='_blank' class='url'>https://music.51vv.com/act/song/KSongBanner.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>AVID</td><td>AVID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品id  参赛作品id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>&nbsp;</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>是否参赛作品</td><td>state</td><td>是</td><td>int</td><td>&nbsp;</td><td>0否,1是</td></tr></tbody>
</table></figure>
<h5>活动模型 AvActivityResult</h5>
<pre><code>    private Long actID;     //id
    private String title;   //活动标题
    private String actImg;  //活动图片
    private Date startTime; //活动开始时间
    private Date endTime;   //活动结束时间
    private String url;     //活动跳转地址
    private Short type;      //1上 2下 3中  
    private Integer property;   //1 左  2 右  3 中
    private Short status;       //活动是否有效
    private Date createTime;       //创建时间
    private Short clientType;       //客户端类型 1 手机端  2 pc端
    private Integer intervalTime;   //图片逗留时长
    private Integer width;          //活动图片宽
    private Integer height;         //活动图片高
    private String testUserID;      //测试用户集合
    private Short activityType;     //1 活动图  2活动页
</code></pre>
<h3>21.10 查询作品详情接口</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/queryKSongAVInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/song/queryKSongAVInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>AVID</td><td>AVID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品id</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>&nbsp;</td><td>1000 成功 1001参数错误 1005操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>作品信息模型</td><td>spaceAv</td><td>是</td><td>object</td><td>&nbsp;</td><td>作品信息模型</td></tr><tr><td>是否投过票</td><td>vote</td><td>是</td><td>int</td><td>&nbsp;</td><td>0没有投,1投了</td></tr><tr><td>是否关注了这个人</td><td>attentionState</td><td>是</td><td>object</td><td>&nbsp;</td><td>0 未关注，1 关注</td></tr></tbody>
</table></figure>
<p><span id="KSongSpaceAv"></span></p>
<h5>作品模型 spaceAv</h5>
<pre><code>    private Integer avID;                //作品ID
    private Long userID;                 //用户ID
    private String name;                 //作品名称
    private String frontCoverUrl;        //封面图片Url
    private String description;          //描述
    private Integer playTimes;           //播放次数
    private Integer praiseTimes;         //点赞次数
    private Integer shareTimes;          //分享次数
    private Integer commentTimes;        //评论次数
    private Timestamp createTime;        //创建时间
    private Integer fileType;            //文件类型 4视频 其他音频
    private String fileURL;              //文件地址
    private Integer kscSongID;             //曲库ID
    private String thumbUrl;             //缩略图
    private Float duration;              //时长
    private Float bitrate;               //码流
    private String fileDomain;           //上传域
    private Integer zpSource;            //作品来源 0翻唱曲库 1清唱 2本地歌曲
    private Integer flowerAmount;        //鲜花数量
    private Long giftAmount;             //礼物数量
    private Short goodVoice;             //好声音标记 1是 0否
    private String cover;                //作品封面
    private Short status;                //作品状态
    private String singerName;        //歌手名
    private String nickName;             //用户昵称
    private String userPhoto;            //用户头像
    private String gender;               //用户性别
    private Integer authType;            //用户认证类型
    private Integer authState;           //用户认证状态
    private String authInfo;             //用户认证信息
    private Date memberExpiretime;
    private Long level_singer;           //用户歌手等级
    private Long ticketCount;            //Ksong总票数
</code></pre>
<h3>21.11  小程序鉴权</h3>
<h5>接口作者：胡明政</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/miniprogram/login.htm' target='_blank' class='url'>https://music.51vv.com/miniprogram/login.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>code</td><td>code</td><td>是</td><td>string</td><td>&nbsp;</td><td>登录时获取的 code</td></tr><tr><td>iv</td><td>iv</td><td>是</td><td>string</td><td>&nbsp;</td><td>加密算法的初始向量</td></tr><tr><td>encryptedData</td><td>encryptedData</td><td>是</td><td>string</td><td>&nbsp;</td><td>用户信息的加密数据</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<p>###Head
请求时Head标注上渠道X-CHANNEL 值为小程序的渠道标识</p>
<p>&nbsp;</p>
<h3>21.12 小程序查询作品详情接口</h3>
<h5>接口作者 胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/queryMiniprogramKSongAVInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/song/queryMiniprogramKSongAVInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>AVID</td><td>AVID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品id</td></tr><tr><td>cid</td><td>cid</td><td>否</td><td>String</td><td>&nbsp;</td><td>小程序cid</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>&nbsp;</td><td>1000 成功 1001参数错误 1005操作失败,1061cid失效</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>否</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>作品信息模型</td><td>spaceAv</td><td>是</td><td>object</td><td>&nbsp;</td><td>作品信息模型</td></tr><tr><td>是否投过票</td><td>vote</td><td>是</td><td>int</td><td>&nbsp;</td><td>0没有投,1投了</td></tr><tr><td>是否关注了这个人</td><td>attentionState</td><td>是</td><td>object</td><td>&nbsp;</td><td>0 未关注，1 关注</td></tr></tbody>
</table></figure>
<p><a href='#KSongSpaceAv'>跳转</a></p>
<p>&nbsp;</p>
<h3>21.13 K歌大赛，小程序用户投票接口</h3>
<h5>接口作者：胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/miniprogramVote.htm?avId=XX' target='_blank' class='url'>https://music.51vv.com/act/song/miniprogramVote.htm?avId=XX</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>cid</td><td>cid</td><td>是</td><td>String</td><td>&nbsp;</td><td>小程序cid</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>1:投票成功，0投票失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,1061cid失效</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>21.14 小程序用户获取本人ID</h3>
<h5>接口作者：胡明政</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/miniprogram/getUserid.htm' target='_blank' class='url'>https://music.51vv.com/miniprogram/getUserid.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>cid</td><td>cid</td><td>是</td><td>String</td><td>&nbsp;</td><td>小程序cid</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>userId</td><td>userId</td><td>是</td><td>long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功,1061cid失效</td></tr></tbody>
</table></figure>
<h3>23.15 K歌大赛-用户进入歌房查询K歌比赛信息</h3>
<h5>接口作者：李志勇</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/initMatchInfo.htm?roomID=465' target='_blank' class='url'>https://music.51vv.com/act/song/initMatchInfo.htm?roomID=465</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>roomID</td><td>roomID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>查询状态</td><td>&nbsp;</td><td>0:查询成功,1:不在比赛时间,2:无正在进行的比赛</td></tr><tr><td>返回结果</td><td>matchState</td><td>否</td><td>比赛状态</td><td>&nbsp;</td><td>1：复赛 2 半决赛  3 决赛</td></tr></tbody>
</table></figure>
<h4>matchState 1：复赛 2 半决赛 返回</h4>
<pre><code>返回结果|userIDFrist|否|选手一用户ID|&amp;nbsp;| 
返回结果|userFristAvNo|否|选手一用户编号|&amp;nbsp;| 
返回结果|userFristTicket|否|选手一用户得票|&amp;nbsp;|
返回结果|userIDSecond|否|选手二用户ID|&amp;nbsp;| 
返回结果|userSecondAvNo|否|选手二用户编号|&amp;nbsp;| 
返回结果|userSecondTicket|否|选手二用户得票|&amp;nbsp;| 
返回结果|totalTicket|否|总票数|&amp;nbsp;| 
返回结果|winUserID|否|获胜用户ID|&amp;nbsp;| 
返回结果|winUserAvNo|否|获胜用户编号|&amp;nbsp;|
返回结果|userFristPhoto|否|选手一用户头像|&amp;nbsp;|
返回结果|userSecondPhoto|否|选手二用户头像|&amp;nbsp;|
返回结果|winUserPhoto|否|获胜用户头像|&amp;nbsp;|
</code></pre>
<h4>matchState 3 决赛 返回</h4>
<pre><code>返回结果|score|否|当前得分|&amp;nbsp;| 
返回结果|currentUserID|否|当前用户ID|&amp;nbsp;| 
返回结果|currentAvNo|否|当前用户编号|&amp;nbsp;|
返回结果|count|否|当前用户荧光棒数量|&amp;nbsp;|
返回结果|rank|否|当前用户排名|&amp;nbsp;|
返回结果|currentPhoto|否|当前用户头像|&amp;nbsp;|
</code></pre>
<h3>21.16 K歌大赛，复赛，复赛分组接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口token必校验</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/selectGroup.htm' target='_blank' class='url'>https://music.51vv.com/act/song/selectGroup.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>选择type</td><td>type</td><td>否</td><td>Shrot</td><td>1、2、3</td><td>复赛分组：1是7月3日，2是7月4日，3是7月5日，不传显示全部;半决赛分组：4是7月7日，5是7月8日</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>返回JSON模型定义</h5>
<pre><code>{
    &quot;retCode&quot;: 1000,
    &quot;allMapList&quot;: [
        {
            &quot;smallMapList&quot;: [
                [
                    {
                        &quot;nickName&quot;: &quot;-&quot;,
                        &quot;avNo&quot;: 0,
                        &quot;userID&quot;: 1,
                        &quot;groupNo&quot;: &quot;A1&quot;，
						&quot;photo&quot;: &quot;&quot;，
						&quot;pkRet&quot;: 1，//1获胜 0失败，
						&quot;avID&quot;: 1892874，
                    },
                    {
                        &quot;nickName&quot;: &quot;-&quot;,
                        &quot;avNo&quot;: 0,
                        &quot;userID&quot;: 2,
                        &quot;groupNo&quot;: &quot;A2&quot;,
						&quot;photo&quot;: &quot;&quot;，
						&quot;pkRet&quot;: 1，//1获胜 0失败，
						&quot;avID&quot;: 1892874，
                    }
                ]
            ],
            &quot;beninTime&quot;: 1562083200000,
            &quot;groupNo&quot;: &quot;A&quot;,
            &quot;roomID&quot;: 111111
        },
        {
            &quot;smallMapList&quot;: [
                [
                    {
                        &quot;nickName&quot;: &quot;-&quot;,
                        &quot;avNo&quot;: 0,
                        &quot;userID&quot;: 17,
                        &quot;groupNo&quot;: &quot;B1&quot;
                    },
                    {
                        &quot;nickName&quot;: &quot;-&quot;,
                        &quot;avNo&quot;: 0,
                        &quot;userID&quot;: 18,
                        &quot;groupNo&quot;: &quot;B2&quot;
                    }
                ]
            ],
            &quot;beninTime&quot;: 1562083200000,
            &quot;groupNo&quot;: &quot;B&quot;,
            &quot;roomID&quot;: 222222
        }
    ],
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>21.17 小程序查询黑名单关系</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/miniprogramBlackRelation.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/act/song/miniprogramBlackRelation.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>被请求用户</td><td>toUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>被请求用户</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>关系</td><td>relation</td><td>否</td><td>Short</td><td>&nbsp;</td><td>类型 0没关系 1被我拉黑 2我被拉黑 3相互拉黑</td></tr></tbody>
</table></figure>
<h3>21.18 小程序关注取消关注</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/miniprogramFollow.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/act/song/miniprogramFollow.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>关注用户（或删除）</td><td>toUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>关注用户（或删除）</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>Short</td><td>&nbsp;</td><td>类型 1关注 2取消关注</td></tr><tr><td>cid</td><td>cid</td><td>是</td><td>String</td><td>&nbsp;</td><td>鉴权cid</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表,1061cid失效</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>类型</td><td>relation</td><td>否</td><td>Short</td><td>&nbsp;</td><td>类型 0未关注 1已关注 2好友</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>21.19 查询是否投票状态</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/checkVoteState.htm?AVID=xxx' target='_blank' class='url'>https://music.51vv.com/act/song/checkVoteState.htm?AVID=xxx</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>AVID</td><td>AVID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>是否投过票</td><td>vote</td><td>是</td><td>int</td><td>&nbsp;</td><td>0没有投,1投了</td></tr></tbody>
</table></figure>
<h3>21.20 复赛名单</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/KSongGroupStageList.htm?viewNumber=xxx&amp;curPage=xxx' target='_blank' class='url'>https://music.51vv.com/act/song/KSongGroupStageList.htm?viewNumber=xxx&curPage=xxx</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>1复赛名单,2半决赛名单,3决赛名单</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>0</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>决赛时间</td><td>finalTime</td><td>否</td><td>date</td><td>&nbsp;</td><td>决赛时间</td></tr><tr><td>外部号</td><td>outside_number</td><td>否</td><td>int</td><td>&nbsp;</td><td>外部号</td></tr><tr><td>内部号</td><td>inner_number</td><td>否</td><td>int</td><td>&nbsp;</td><td>内部号</td></tr></tbody>
</table></figure>
<h5>返回模型 groupStageList</h5>
<pre><code>   	private Integer avID;                //作品ID
    private Long userID;                 //用户ID
    private String name;                 //作品名称
    private Integer fileType;            //文件类型 4视频 其他音频
    private String fileURL;              //文件地址
    private Integer kscSongID;           //曲库ID
    private String thumbUrl;             //缩略图
    private Float duration;              //时长
    private Float bitrate;               //码流
    private String fileDomain;           //上传域
    private Integer zpSource;            //作品来源 0翻唱曲库 1清唱 2本地歌曲
    private Integer flowerAmount;        //鲜花数量
    private Long giftAmount;             //礼物数量
    private Short goodVoice;             //好声音标记 1是 0否
    private String cover;                //作品封面
    private Short status;                //作品状态
    private String nickName;             //用户昵称
    private String userPhoto;            //用户头像
    private String gender;               //用户性别
    private Long ticketCount;            //Ksong总票数
    private Long avNo;                   //编号
    private Float score;                //平均分
    private Float totalScore;           //总分
    private Long id;                    //名次
    private Float scoreJudge;           //评委打分
    private Date createTime;            //创建时间
</code></pre>
<h3>21.21 K歌决赛人气榜</h3>
<h5>接口作者：李志勇</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/queryKSongPopularity.htm' target='_blank' class='url'>https://music.51vv.com/act/song/queryKSongPopularity.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>人气榜</td><td>songList</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>人气榜 songList</h5>
<pre><code>   private Long userID;
   private Long popularValue;//荧光棒数量
   private Integer rank;//排名
   private String userName;//用户姓名
   private String userPhoto;//用户头像
   private Long avNo;//编号
</code></pre>
<h3>21.22 获取赛段进程</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/getStageDevelopment.htm' target='_blank' class='url'>https://music.51vv.com/act/song/getStageDevelopment.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 类型 | 示例值 | 描述
---|---|---|---|---</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>Int</td><td>1000</td><td>状态码</td></tr><tr><td>返回结果</td><td>retMsg</td><td>String</td><td>成功</td><td>状态信息</td></tr><tr><td>返回信息</td><td>stageStartDate</td><td>String</td><td>2019-06-01 00:00:00</td><td>比赛开始时间</td></tr><tr><td>返回信息</td><td>stageEndDate</td><td>String</td><td>2019-06-18 00:00:00</td><td>比赛开始时间</td></tr><tr><td>返回信息</td><td>timeLength</td><td>Int</td><td>18</td><td>赛长（天）</td></tr><tr><td>返回信息</td><td>currentLength</td><td>Int</td><td>3</td><td>比赛进度（天）</td></tr><tr><td>返回信息</td><td>stageLists</td><td>{}</td><td>{}</td><td>赛段集合</td></tr><tr><td>返回信息</td><td>number</td><td>Int</td><td>2</td><td>赛段名</td></tr><tr><td>返回信息</td><td>name</td><td>String</td><td>初赛</td><td>赛段名</td></tr><tr><td>返回信息</td><td>startTime</td><td>String</td><td>2019-06-01 00:00:00</td><td>赛段开始时间</td></tr><tr><td>返回信息</td><td>endTime</td><td>String</td><td>2019-06-03 00:00:00</td><td>赛段开始时间</td></tr><tr><td>返回信息</td><td>dateStr</td><td>String</td><td>06月01日-06月03日</td><td>赛段时间信息</td></tr></tbody>
</table></figure>
<h3>21.23 获取我所支持作品列表</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/getMySupportSongLists.htm' target='_blank' class='url'>https://music.51vv.com/act/song/getMySupportSongLists.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页数</td><td>songListcurPages</td><td>Int</td><td>3</td><td>当前页</td></tr><tr><td>条数</td><td>viewNumber</td><td>Int</td><td>3</td><td>条数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>Int</td><td>1000</td><td>状态码</td></tr><tr><td>返回结果</td><td>retMsg</td><td>String</td><td>成功</td><td>状态信息</td></tr><tr><td>返回信息</td><td>currentVoteCount</td><td>Int</td><td>8</td><td>剩余票数</td></tr><tr><td>返回信息</td><td>songLists</td><td>{}</td><td>{}</td><td>支持作品集合</td></tr><tr><td>返回信息</td><td>avID</td><td>Int</td><td>18</td><td>参赛作品ID</td></tr><tr><td>返回信息</td><td>avNo</td><td>Int</td><td>3</td><td>作品名称</td></tr><tr><td>返回信息</td><td>cover</td><td>String</td><td><a href='http://msgUrl9.png' target='_blank' class='url'>http://msgUrl9.png</a></td><td>封面</td></tr><tr><td>返回信息</td><td>worksName</td><td>String</td><td>好好学习</td><td>作品名称</td></tr><tr><td>返回信息</td><td>nickName</td><td>String</td><td>Neil</td><td>用户昵称</td></tr><tr><td>返回信息</td><td>voteCount</td><td>Int</td><td>3</td><td>作品投票数</td></tr><tr><td>返回信息</td><td>voteState</td><td>Int</td><td>0</td><td>今日投票状态 0是投票 1是已投</td></tr><tr><td>返回信息</td><td>totalSize</td><td>Int</td><td>100</td><td>作品总数</td></tr></tbody>
</table></figure>
<h3>21.24 获取所有作品列表</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/getSongLists.htm' target='_blank' class='url'>https://music.51vv.com/act/song/getSongLists.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页数</td><td>songListcurPages</td><td>Int</td><td>3</td><td>当前页</td></tr><tr><td>条数</td><td>viewNumber</td><td>Int</td><td>3</td><td>条数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>Int</td><td>1000</td><td>状态码</td></tr><tr><td>返回结果</td><td>retMsg</td><td>String</td><td>成功</td><td>状态信息</td></tr><tr><td>返回信息</td><td>currentVoteCount</td><td>Int</td><td>8</td><td>剩余票数</td></tr><tr><td>返回信息</td><td>songLists</td><td>{}</td><td>{}</td><td>支持作品集合</td></tr><tr><td>返回信息</td><td>avID</td><td>Int</td><td>18</td><td>参赛作品ID</td></tr><tr><td>返回信息</td><td>avNo</td><td>Int</td><td>3</td><td>作品名称</td></tr><tr><td>返回信息</td><td>cover</td><td>String</td><td><a href='http://msgUrl9.png' target='_blank' class='url'>http://msgUrl9.png</a></td><td>封面</td></tr><tr><td>返回信息</td><td>worksName</td><td>String</td><td>好好学习</td><td>作品名称</td></tr><tr><td>返回信息</td><td>nickName</td><td>String</td><td>Neil</td><td>用户昵称</td></tr><tr><td>返回信息</td><td>voteCount</td><td>Int</td><td>3</td><td>作品投票数</td></tr><tr><td>返回信息</td><td>voteState</td><td>Int</td><td>0</td><td>今日投票状态 0是投票 1是已投</td></tr><tr><td>返回信息</td><td>totalSize</td><td>Int</td><td>100</td><td>作品总数</td></tr></tbody>
</table></figure>
<h3>21.25 翻看我的分组</h3>
<h5>接口作者：王秋杰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/checkGroup.htm' target='_blank' class='url'>https://music.51vv.com/act/song/checkGroup.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>翻看分组</td><td>openGroup</td><td>Int</td><td>0</td><td>默认为0 查看基本信息 1点击翻看分组</td></tr><tr><td>赛段类型</td><td>type</td><td>Int</td><td>1</td><td>默认为1 1:复赛分组;2:半决赛分组;3决赛分组</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>Int</td><td>1000</td><td>状态码</td></tr><tr><td>返回结果</td><td>retMsg</td><td>String</td><td>成功</td><td>状态信息</td></tr><tr><td>返回结果</td><td>groupState</td><td>Int</td><td>0</td><td>用户状态 0未翻看分组 1已翻看分组 2不显示该模块</td></tr><tr><td>返回结果</td><td>nickName</td><td>String</td><td>CY_大西瓜</td><td>用户昵称</td></tr><tr><td>返回结果</td><td>userId</td><td>Long</td><td>1000045</td><td>用户ID</td></tr><tr><td>返回结果</td><td>avId</td><td>Long</td><td>1234567</td><td>作品Id</td></tr><tr><td>返回结果</td><td>photo</td><td>String</td><td><a href='http://upcdn.f0716144818cfd.jpg' target='_blank' class='url'>http://upcdn.f0716144818cfd.jpg</a></td><td>用户头像</td></tr><tr><td>返回结果</td><td>groupDetailed</td><td>{}</td><td>{}</td><td>用户分组明细</td></tr><tr><td>返回结果</td><td>groupNo</td><td>String</td><td>A</td><td>分组</td></tr><tr><td>返回结果</td><td>groupID</td><td>Int</td><td>16</td><td>编号</td></tr><tr><td>返回结果</td><td>beginTime</td><td>String</td><td>2019-07-03 00:00:00</td><td>开始时间</td></tr><tr><td>返回结果</td><td>roomID</td><td>Int</td><td>88999</td><td>歌房</td></tr></tbody>
</table></figure>
<h3>21.26 颁奖典礼决赛</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/JueSaiResult.htm' target='_blank' class='url'>https://music.51vv.com/act/song/JueSaiResult.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>数据集</td><td>mapList</td><td>是</td><td>String</td><td>&nbsp;</td><td>返回结果数据集合</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;userID&quot;: 51013,		用户id
            &quot;avgScore&quot;: 9.56,		平均分值
            &quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/15/10/22/151022225610bb0c040f3d8f42d6_300.jpg&quot;,  小头像
            &quot;nickName&quot;: &quot;天格&quot;,					昵称
            &quot;title&quot;: &quot;巅峰歌王&quot;					称号
        },
        {
            &quot;userID&quot;: 21023,
            &quot;avgScore&quot;: 6.57,
            &quot;photo&quot;: &quot;&quot;,
            &quot;nickName&quot;: &quot;21023&quot;,
            &quot;title&quot;: &quot;悦耳之声&quot;
        }
 
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>21.27 颁奖典礼半决赛</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/banJueSaiResult.htm' target='_blank' class='url'>https://music.51vv.com/act/song/banJueSaiResult.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>数据集</td><td>mapList</td><td>是</td><td>String</td><td>&nbsp;</td><td>返回结果数据集合</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;nickName&quot;: &quot;👄嘟嘟&quot;,		昵称
            &quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/09/03/18090317131174a2d5d2b75f44be_300.jpg&quot;,		小头像
            &quot;avNo&quot;: 9996226,					参赛作品编号
            &quot;userID&quot;: 20006						用户id
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>21.28 直播主播间他的参赛作品接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/liveSpaceAvInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/song/liveSpaceAvInfo.htm</a></p>
<h4>请求参数</h4>
<h4>GET请求</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播ID</td><td>userId</td><td>Long</td><td>900002773</td><td>主播ID</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>参赛主播的作品id</td><td>avId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>参赛主播的作品id</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;avId&quot;:88888,
	&quot;avNo&quot;:88888,//参赛编号
	&quot;vote&quot;:1,//1是已投，0是未投
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>21.29 颁奖典礼初赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/chuSaiResult.htm' target='_blank' class='url'>https://music.51vv.com/act/song/chuSaiResult.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>数据集</td><td>mapList</td><td>是</td><td>String</td><td>&nbsp;</td><td>返回结果数据集合</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;nickName&quot;: &quot;👄嘟嘟&quot;,		昵称
            &quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/09/03/18090317131174a2d5d2b75f44be_300.jpg&quot;,		小头像
            &quot;avNo&quot;: 9996226,					参赛作品编号
            &quot;userID&quot;: 20006						用户id
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>21.30 颁奖典礼复赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/fuSaiResult.htm' target='_blank' class='url'>https://music.51vv.com/act/song/fuSaiResult.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>数据集</td><td>mapList</td><td>是</td><td>String</td><td>&nbsp;</td><td>返回结果数据集合</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;nickName&quot;: &quot;👄嘟嘟&quot;,		昵称
            &quot;photo&quot;: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/09/03/18090317131174a2d5d2b75f44be_300.jpg&quot;,		小头像
            &quot;avNo&quot;: 9996226,					参赛作品编号
            &quot;userID&quot;: 20006						用户id
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<p>&nbsp;</p>
<h3>22.1 七夕活动-获取直播间数据</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getLiveRoomData.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getLiveRoomData.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>anchorRank</td><td>是</td><td>int</td><td>&nbsp;</td><td>主播排行</td></tr><tr><td>返回结果</td><td>moonlightValue</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播所有月光值</td></tr><tr><td>返回结果</td><td>moonlightBoxLevel</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前宝箱等级</td></tr><tr><td>返回结果</td><td>moonlightBoxLevelValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>现在经验值</td></tr><tr><td>返回结果</td><td>moonlightBoxLevelAllValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>距离下一级所需经验值总经验值</td></tr><tr><td>返回结果</td><td>userExchangeVouchers</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户兑换券</td></tr><tr><td>返回结果</td><td>userId</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户id</td></tr><tr><td>返回结果</td><td>upgrade</td><td>是</td><td>int</td><td>&nbsp;</td><td>true 有可抢宝箱 false 没有</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>22.1 七夕活动-获取直播间数据</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getLiveRoomData.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getLiveRoomData.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>anchorRank</td><td>是</td><td>int</td><td>&nbsp;</td><td>主播排行</td></tr><tr><td>返回结果</td><td>moonlightValue</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播所有月光值</td></tr><tr><td>返回结果</td><td>moonlightBoxLevel</td><td>是</td><td>int</td><td>&nbsp;</td><td>当前宝箱等级</td></tr><tr><td>返回结果</td><td>moonlightBoxLevelValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>现在经验值</td></tr><tr><td>返回结果</td><td>moonlightBoxLevelAllValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>距离下一级所需经验值总经验值</td></tr><tr><td>返回结果</td><td>userExchangeVouchers</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户兑换券</td></tr><tr><td>返回结果</td><td>userId</td><td>是</td><td>int</td><td>&nbsp;</td><td>用户id</td></tr><tr><td>返回结果</td><td>upgrade</td><td>是</td><td>int</td><td>&nbsp;</td><td>true 有可抢宝箱 false 没有</td></tr><tr><td>返回结果</td><td>isEnd</td><td>是</td><td>int</td><td>&nbsp;</td><td>0 活动未开始 1活动正在进行 2 活动已结束</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;upgrade&quot;: false,
	&quot;moonlightBoxLevelAllValue&quot;: 50000,
	&quot;moonlightValue&quot;: 3208,
	&quot;userExchangeVouchers&quot;: 0,
	&quot;retCode&quot;: 1000,
	&quot;isEnd&quot;: 1,
	&quot;moonlightBoxLevelValue&quot;: 3208,
	&quot;retMsg&quot;: &quot;成功&quot;,
	&quot;userId&quot;: 22017,
	&quot;moonlightBoxLevel&quot;: 0,
	&quot;anchorRank&quot;: 2
}
</code></pre>
<h3>22.2 七夕活动-用户获取月光宝盒礼物</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getMoonlightboxGift.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getMoonlightboxGift.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>22.3 七夕活动-获取用户在当前主播直播间是否有可抢宝盒</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getUserIsMoonLightBoxByAnchor.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserIsMoonLightBoxByAnchor.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播id</td></tr><tr><td>月光宝盒等级</td><td>moonlightBoxLevel</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>upgrade</td><td>是</td><td>int</td><td>&nbsp;</td><td>true 有可抢宝箱 false 没有</td></tr></tbody>
</table></figure>
<h3>22.4 七夕活动-获取月光榜</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getMoonLightList.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getMoonLightList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>qiXiAnchorLists</td><td>是</td><td>List</td><td>&nbsp;</td><td>榜单列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;retMsg&quot;: &quot;成功&quot;,
	&quot;qiXiAnchorLists&quot;: [{
		&quot;moonlightValue&quot;: 530,          //月光值
		&quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/afe2MvejuiEV.jpg&quot;,  //头像
		&quot;nickname&quot;: &quot;嘻嘻嘻哈哈哈哈哈\uD83D\uDE04。。&quot;,               // 昵称
		&quot;userid&quot;: 707355980,                                        //用户id
		&quot;moonlightBoxLevel&quot;: 0                                      //月光宝盒等级
	}, {
		&quot;moonlightValue&quot;: 20,
		&quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aZZbiaeYrYZR.jpg&quot;,
		&quot;nickname&quot;: &quot;Rita&quot;,
		&quot;userid&quot;: 900007305,
		&quot;moonlightBoxLevel&quot;: 0
	}]
}
</code></pre>
<h3>22.5 七夕活动-获取助力榜</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getHelpValueList.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getHelpValueList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>qiXiUserLists</td><td>是</td><td>List</td><td>&nbsp;</td><td>榜单列表</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;qiXiUserLists&quot;: [{
		&quot;helpValue&quot;: 530,       //助力值
		&quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aJn6feeqMraU.jpg&quot;,    //头像
		&quot;nickname&quot;: &quot;707355907&quot;,                //昵称
		&quot;exchangeVouchers&quot;: 0,                  //兑换券数量
		&quot;userid&quot;: 707355907                     //用户id
	}, {
		&quot;helpValue&quot;: 20,
		&quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/afe2MvejuiEV.jpg&quot;,
		&quot;nickname&quot;: &quot;嘻嘻嘻哈哈哈哈哈\uD83D\uDE04。。&quot;,
		&quot;exchangeVouchers&quot;: 0,
		&quot;userid&quot;: 707355980
	}],
	&quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>22.6 七夕活动-获取用户当前的月光榜信息</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getUserMoonLightValueInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserMoonLightValueInfo.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>qiXiAnchorInfoAndRank</td><td>是</td><td>map</td><td>&nbsp;</td><td>主播信息</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;retMsg&quot;: &quot;成功&quot;,
	&quot;qiXiAnchorInfoAndRank&quot;: {
		&quot;moonlightValue&quot;: 530,          //月光值
		&quot;rank&quot;:2,                       //排行
		&quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/afe2MvejuiEV.jpg&quot;,  //头像
		&quot;userid&quot;: 707355980,                                        //用户id
		&quot;moonlightBoxLevel&quot;: 0                                      //月光宝盒等级
	}
}

</code></pre>
<p>&nbsp;</p>
<h3>22.7 七夕活动-获取用户当前的助力值</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getUserHelpValue.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserHelpValue.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>qiXiUserInfoAndRank</td><td>是</td><td>map</td><td>&nbsp;</td><td>用户信息</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;qiXiAnchorInfoAndRank&quot;: {
		&quot;helpValue&quot;: 530,       //助力值
		&quot;rank&quot;:2,                       //排行
		&quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aJn6feeqMraU.jpg&quot;,    //头像
		&quot;exchangeVouchers&quot;: 0,                  //兑换券数量
		&quot;userid&quot;: 707355907                     //用户id
	},
	&quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>22.8 七夕活动-兑换的礼物列表</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getExchangeGiftList.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getExchangeGiftList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>qiXiMountInfo</td><td>是</td><td>List</td><td>&nbsp;</td><td>坐骑信息</td></tr><tr><td>返回结果</td><td>exchangeVouchers</td><td>是</td><td>int</td><td>&nbsp;</td><td>现有兑换券信息</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;exchangeVouchers&quot;:0,
	&quot;qiXiMountInfo&quot;: {
		&quot;userExchangeMountNum&quot;: 0,       //用户已兑换数量
		&quot;mountGiftId&quot;:2,                 //礼物id
		&quot;giftName&quot;:2,                 //礼物名称
		&quot;giftPicture&quot;: &quot;aJn6feeqMraU.jpg&quot;,    // 图片
		&quot;exchangeNum&quot;: 18,    //可兑换数量
		&quot;needExchangeVouchers&quot;: 5    //需要的兑换券
	},
	&quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<h3>22.9 七夕活动-兑换坐骑</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/exchangeMoonList.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/exchangeMoonList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>礼物id</td><td>giftId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>qiXiMountInfo</td><td>是</td><td>List</td><td>&nbsp;</td><td>坐骑信息</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;exchangeVouchers&quot;:0,
	&quot;qiXiMountInfo&quot;: {
		&quot;userExchangeMountNum&quot;: 0,       //用户已兑换数量
		&quot;mountGiftId&quot;:2,                 //礼物id
		&quot;giftName&quot;:2,                 //礼物名称
		&quot;giftPicture&quot;: &quot;aJn6feeqMraU.jpg&quot;,    // 图片
		&quot;exchangeNum&quot;: 18,    //可兑换数量
		&quot;needExchangeVouchers&quot;: 5    //需要的兑换券
	},
	&quot;retMsg&quot;: &quot;成功&quot;
}
</code></pre>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3>23.1 朗诵大赛-用户进入歌房查询K歌比赛信息</h3>
<h5>接口作者：刘冰</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/read/initMatchInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/read/initMatchInfo.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>roomID</td><td>roomID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>activityId</td><td>activityId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>查询状态</td><td>&nbsp;</td><td>0:查询成功,1:不在比赛时间,2:无正在进行的比赛</td></tr><tr><td>返回结果</td><td>matchState</td><td>否</td><td>比赛状态</td><td>&nbsp;</td><td>赛程分类 10报名  20初赛 30 复赛 40 半决赛 50 决赛</td></tr><tr><td>赛段信息</td><td>KReadActivityPhase</td><td>Object</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>matchState 30 复赛 返回</h4>
<pre><code>返回结果|userIDFrist|否|选手一用户ID|&amp;nbsp;|
返回结果|userFristAvNo|否|选手一用户编号|&amp;nbsp;|
返回结果|userFristTicket|否|选手一用户得票|&amp;nbsp;|
返回结果|userIDSecond|否|选手二用户ID|&amp;nbsp;|
返回结果|userSecondAvNo|否|选手二用户编号|&amp;nbsp;|
返回结果|userSecondTicket|否|选手二用户得票|&amp;nbsp;|
返回结果|totalTicket|否|总票数|&amp;nbsp;|
返回结果|winUserID|否|获胜用户ID|&amp;nbsp;|
返回结果|winUserAvNo|否|获胜用户编号|&amp;nbsp;|
返回结果|userFristPhoto|否|选手一用户头像|&amp;nbsp;|
返回结果|userSecondPhoto|否|选手二用户头像|&amp;nbsp;|
返回结果|winUserPhoto|否|获胜用户头像|&amp;nbsp;|
</code></pre>
<h4>matchState 50 决赛 返回</h4>
<pre><code>返回结果|score|否|当前得分|&amp;nbsp;|
返回结果|currentUserID|否|当前用户ID|&amp;nbsp;|
返回结果|currentAvNo|否|当前用户编号|&amp;nbsp;|
返回结果|count|否|当前用户荧光棒数量|&amp;nbsp;|
返回结果|rank|否|当前用户排名|&amp;nbsp;|
返回结果|currentPhoto|否|当前用户头像|&amp;nbsp;|
</code></pre>
<h3>23.2 朗诵大赛-报名接口</h3>
<h5>接口作者：刘冰</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/read/signKRead.htm' target='_blank' class='url'>https://music.51vv.com/act/read/signKRead.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>手机号</td><td>phone</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>赛段id</td><td>phaseID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>0:报名成功,1:不在申请时间范围内,2:不在申请白名单之内,3:报名信息已存在</td></tr></tbody>
</table></figure>
<h3>23.3 朗诵大赛-查询当前正在执行的赛段</h3>
<h5>接口作者：刘冰</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/read/getKReadPhaseID.htm' target='_blank' class='url'>https://music.51vv.com/act/read/getKReadPhaseID.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>赛程分类</td><td>type</td><td>是</td><td>Short</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>活动id</td><td>activityId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>1 不在申请时间范围内</td></tr><tr><td>赛段信息</td><td>KReadActivityPhase</td><td>Object</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h3>23.4 朗诵大赛-查询该用户是否可报名</h3>
<h5>接口作者：刘冰</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/read/vaildKReadStatus.htm' target='_blank' class='url'>https://music.51vv.com/act/read/vaildKReadStatus.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动id</td><td>activityId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>0:未报名,1:不在申请时间范围内,2:不在申请白名单之内,3：审核未通过,4:审核通过,5:报名中</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>23.5 朗诵大赛-评委打分接口</h3>
<h5>接口作者：刘冰</h5>
<h5>接口token必校验</h5>
<h5>接口示例链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/read/scoreKRead.htm' target='_blank' class='url'>https://music.51vv.com/act/read/scoreKRead.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打分一</td><td>scoreOne</td><td>是</td><td>double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打分二</td><td>scoreTwo</td><td>是</td><td>double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>打分三</td><td>scoreThree</td><td>是</td><td>double</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>活动id</td><td>activityId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>state</td><td>是</td><td>申请状态</td><td>&nbsp;</td><td>0:打分成功,1:不在评委白名单之内,2:该评委已打分,3:该作品只能有5位评委评分</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>23.5 朗诵大赛-朗诵大赛决赛人气榜</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/song/queryKReadPopularity.htm' target='_blank' class='url'>https://music.51vv.com/act/song/queryKReadPopularity.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动id</td><td>activityId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>赛段id</td><td>phaseID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 10001 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>人气榜</td><td>songList</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>人气榜 songList</h5>
<pre><code>   private Long userID;
   private Long popularValue;//荧光棒数量
   private Integer rank;//排名
   private String userName;//用户姓名
   private String userPhoto;//用户头像
   private Long avNo;//编号
</code></pre>
<h3>24.1 话题列表页</h3>
<h5>接口作者：梁毅</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/core/list.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/core/list.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th><th>&nbsp;</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败返回结果</td><td>&nbsp;</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td><td>&nbsp;</td></tr><tr><td>话题列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code class='language-java' lang='java'>
private Integer topicId;			    //话题id
private String name;                    //话题名
private String topicRuleDesc;			//置顶标识 1是 0否
private String topicDesc;			    //话题描述
private String bgImageUrl;			    //背景图片url
private String indexImageUrl;		    //封面图片url
private Short state;
private Short topFlag;                  //置顶 1 - 置顶
private Integer topScore;				//话题置顶顺序 升序
private Short topicType;                //话题类型 1 - 官方
private Date createTime;
private Date updateTime;
private Date lastContentPublishTime;   //话题最后内容发布时间
private Date startTime;
private Date endTime;
private Long score;				        //话题热度
private Long count;
</code></pre>
<pre><code>{
	&quot;topicList&quot;: [ {
		&quot;createTime&quot;: 1568874809000,
		&quot;bgImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;count&quot;: 50,
		&quot;updateTime&quot;: 1570740567000,
		&quot;score&quot;: 58,
		&quot;state&quot;: 1,
		&quot;topFlag&quot;: 0,
		&quot;endTime&quot;: 1885444383000,
		&quot;topicDesc&quot;: &quot;就是一个测试话题&quot;,
		&quot;lastContentPublishTime&quot;: 1568874809000,
		&quot;startTime&quot;: 1568874778000,
		&quot;indexImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;topScore&quot;: 0,
		&quot;topicType&quot;: 1,
		&quot;name&quot;: &quot;测试话题16&quot;,
		&quot;topicId&quot;: 16,
		&quot;topicRuleDesc&quot;: &quot;就是一个测试话题&quot;
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<p>&nbsp;</p>
<h3>24.2 精选话题列表页</h3>
<h5>接口作者：梁毅</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/core/good.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/core/good.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败返回结果</td></tr><tr><td>话题列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code class='language-java' lang='java'>
private Integer topicId;			    //话题id
private String name;                    //话题名
private String topicRuleDesc;			//置顶标识 1是 0否
private String topicDesc;			    //话题描述
private String bgImageUrl;			    //背景图片url
private String indexImageUrl;		    //封面图片url
private Short state;
private Short topFlag;                  //置顶 1 - 置顶
private Integer topScore;				//话题置顶顺序 升序
private Short topicType;                //话题类型 1 - 官方
private Date createTime;
private Date updateTime;
private Date lastContentPublishTime;   //话题最后内容发布时间
private Date startTime;
private Date endTime;
private Long score;				        //话题热度
private Long count;
</code></pre>
<pre><code>{
	&quot;topicList&quot;: [ {
		&quot;createTime&quot;: 1568874809000,
		&quot;bgImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;count&quot;: 50,
		&quot;updateTime&quot;: 1570740567000,
		&quot;score&quot;: 58,
		&quot;state&quot;: 1,
		&quot;topFlag&quot;: 0,
		&quot;endTime&quot;: 1885444383000,
		&quot;topicDesc&quot;: &quot;就是一个测试话题&quot;,
		&quot;lastContentPublishTime&quot;: 1568874809000,
		&quot;startTime&quot;: 1568874778000,
		&quot;indexImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;topScore&quot;: 0,
		&quot;topicType&quot;: 1,
		&quot;name&quot;: &quot;测试话题16&quot;,
		&quot;topicId&quot;: 16,
		&quot;topicRuleDesc&quot;: &quot;就是一个测试话题&quot;
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<p>&nbsp;</p>
<h3>24.3 推荐话题列表（上传选取）页</h3>
<h5>接口作者：梁毅</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/core/recommand.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/core/recommand.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>歌曲id</td><td>songId</td><td>是</td><td>Integer</td><td>99999</td><td>作品的歌曲id</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败返回结果</td></tr><tr><td>话题列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code class='language-java' lang='java'>
private Integer topicId;			    //话题id
private String name;                    //话题名
private String topicRuleDesc;			//置顶标识 1是 0否
private String topicDesc;			    //话题描述
private String bgImageUrl;			    //背景图片url
private String indexImageUrl;		    //封面图片url
private Short state;
private Short topFlag;                  //置顶 1 - 置顶
private Integer topScore;				//话题置顶顺序 升序
private Short topicType;                //话题类型 1 - 官方
private Date createTime;
private Date updateTime;
private Date lastContentPublishTime;   //话题最后内容发布时间
private Date startTime;
private Date endTime;
private Long score;				        //话题热度
private Long count;
</code></pre>
<pre><code>{
	&quot;topicList&quot;: [ {
		&quot;createTime&quot;: 1568874809000,
		&quot;bgImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;count&quot;: 50,
		&quot;updateTime&quot;: 1570740567000,
		&quot;score&quot;: 58,
		&quot;state&quot;: 1,
		&quot;topFlag&quot;: 0,
		&quot;endTime&quot;: 1885444383000,
		&quot;topicDesc&quot;: &quot;就是一个测试话题&quot;,
		&quot;lastContentPublishTime&quot;: 1568874809000,
		&quot;startTime&quot;: 1568874778000,
		&quot;indexImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;topScore&quot;: 0,
		&quot;topicType&quot;: 1,
		&quot;name&quot;: &quot;测试话题16&quot;,
		&quot;topicId&quot;: 16,
		&quot;topicRuleDesc&quot;: &quot;就是一个测试话题&quot;
	}],
	&quot;retCode&quot;: 1000
}
</code></pre>
<p>&nbsp;</p>
<h3>24.4 话题详情</h3>
<h5>接口作者：梁毅</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/core/detail.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/core/detail.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>topicId</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>话题id</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>话题详情</td><td>topic</td><td>是</td><td>Object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code class='language-java' lang='java'>    private Integer topicId;			    //话题id
    private String name;                   //话题名
    private String topicRuleDesc;			//置顶标识 1是 0否
    private String topicDesc;			    //话题描述
    private String bgImageUrl;			    //背景图片url
    private String indexImageUrl;		    //封面图片url
    private Short topFlag;                  //置顶 1 - 置顶
    private Integer topScore;				//话题置顶顺序 升序
    private Short topicType;                //话题类型 1 - 官方
    private Date createTime;
    private Date updateTime;
    private Date lastContentPublishTime;   //话题最后内容发布时间
    private Date startTime;
    private Date endTime;
    private Long score;				        //话题热度
    private Long count;
    private Integer isEnd                   //是否结束 0为未结束
</code></pre>
<pre><code>{
	&quot;topic&quot;: {
		&quot;topScore&quot;: 0,
		&quot;indexImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;bgImageUrl&quot;: &quot;https://www.gravatar.com/avatar/b7ca80d9d65f277a1e808d98c88dd51a?s=180&amp;d=identicon&quot;,
		&quot;isEnd&quot;: 0,
		&quot;name&quot;: &quot;测试话题&quot;,
		&quot;score&quot;: 1017,
		&quot;topFlag&quot;: 0,
		&quot;topicId&quot;: 1,
		&quot;topicRuleDesc&quot;: &quot;就是一个测试话题&quot;,
		&quot;topicDesc&quot;: &quot;就是一个测试话题&quot;
	},
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>24.5 话题回调</h3>
<p> </p>
<h5>接口作者：梁毅</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/core/view_call.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/core/view_call.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>topicId</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>话题id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr></tbody>
</table></figure>
<h3>24.6 话题关联伴奏</h3>
<h5>接口作者：梁毅</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/song/list.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/song/list.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>topicId</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>话题id</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>伴奏列表</td><td>topic</td><td>是</td><td>List</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>伴奏对象</h5>
<pre><code class='language-java' lang='java'>private Long songId;						//伴奏id
private String name;				//伴奏曲名
private Long fileSize;		//伴奏大小
private String singerName;			//歌手
</code></pre>
<pre><code>{
	&quot;topic&quot;: [{
		&quot;fileSize&quot;: 1949184,
		&quot;singerName&quot;: &quot;F4&quot;,
		&quot;name&quot;: &quot;Ask For More&quot;,
		&quot;songId&quot;: 1000
	}, {
		&quot;fileSize&quot;: 2702016,
		&quot;singerName&quot;: &quot;朱孝天&quot;,
		&quot;name&quot;: &quot;Heat Or The Night&quot;,
		&quot;songId&quot;: 1002
	}, {
		&quot;fileSize&quot;: 2140704,
		&quot;singerName&quot;: &quot;言承旭&quot;,
		&quot;name&quot;: &quot;只有我&quot;,
		&quot;songId&quot;: 1007
	}, {
		&quot;fileSize&quot;: 2082816,
		&quot;singerName&quot;: &quot;吴建豪&quot;,
		&quot;name&quot;: &quot;心理测验&quot;,
		&quot;songId&quot;: 1010
	}],
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>24.7 活跃用户列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/user/activate.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/user/activate.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>topicId</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>每页的长度</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>活跃用户列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>显示20条</td></tr></tbody>
</table></figure>
<h5>活跃用户对象</h5>
<pre><code class='language-java' lang='java'>private Long userId;						//用户ID
private String nickName;				//用户昵称
private Long score;					//用户点赞数
private String photo;			//头像url
private String pendant          //封面
private Integer authType        //身份
</code></pre>
<pre><code>{
	&quot;topicList&quot;: {
		&quot;topicUserCount&quot;: 16,
		&quot;topicUsers&quot;: [{
			&quot;nickName&quot;: &quot;7852513哈哈天天&quot;,
			&quot;pendant&quot;: &quot;http://cdn.file.51vv.com/vvmobilelive/pendant/20190906.png&quot;,
			&quot;userId&quot;: 7852513,
			&quot;score&quot;: 10,
			&quot;authType&quot;: 2,
			&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aaERnmayei2Y.jpg&quot;
		}, {
			&quot;nickName&quot;: &quot;7852514&quot;,
			&quot;pendant&quot;: &quot;&quot;,
			&quot;userId&quot;: 7852514,
			&quot;score&quot;: 4,
			&quot;authType&quot;: 5,
			&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aIrIrqifuYbQ.jpg&quot;
		}]
	},
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>24.8 话题用户列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/user/latest.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/user/latest.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>topicId</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>活跃用户列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>显示20条</td></tr></tbody>
</table></figure>
<h5>活跃用户对象</h5>
<pre><code class='language-java' lang='java'>private Long userId;						//用户ID
private String nickName;				//用户昵称
private Long score;					//用户点赞数
private String photo;			//头像url
private String pendant          //封面
private Integer authType        //身份
</code></pre>
<pre><code>{
	&quot;topicList&quot;: {
		&quot;topicUserCount&quot;: 16,
		&quot;topicUsers&quot;: [{
			&quot;nickName&quot;: &quot;7852513哈哈天天&quot;,
			&quot;pendant&quot;: &quot;http://cdn.file.51vv.com/vvmobilelive/pendant/20190906.png&quot;,
			&quot;userId&quot;: 7852513,
			&quot;score&quot;: 10,
			&quot;authType&quot;: 2,
			&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aaERnmayei2Y.jpg&quot;
		}, {
			&quot;nickName&quot;: &quot;7852514&quot;,
			&quot;pendant&quot;: &quot;&quot;,
			&quot;userId&quot;: 7852514,
			&quot;score&quot;: 4,
			&quot;authType&quot;: 5,
			&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aIrIrqifuYbQ.jpg&quot;
		}]
	},
	&quot;retCode&quot;: 1000
}

</code></pre>
<p>&nbsp;</p>
<h3>24.9 话题作品列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/content/latest.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/content/latest.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题id</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>话题id</td></tr><tr><td>最后时间戳</td><td>toTimeStamp</td><td>否</td><td>Integer</td><td>15</td><td>不传为最新，下拉时往前传</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>话题作品列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>显示20条</td></tr></tbody>
</table></figure>
<h5>作品对象</h5>
<pre><code class='language-java' lang='java'>
    private Long avid;               //作品ID
	private String name;             //作品名称
	private String frontCoverUrl;    //封面图片Url
	private String description;      //描述
	private String originalDescription;
	private Short exFileType;      //扩展文件类型 扩展文件类型 0 独唱 1 合唱 2 发起合唱
	private Long semiAVID;           //发起合唱作品ID
	private Short status;          //作品状态
	private Short zpSource;        //作品来源 0 翻唱曲库 1 清唱 2 本地歌曲
	private String recordParams;     //录歌参数
	private Short privateUpload;   //是否私密上传 1是 0不是
	private Short isAccept;          //是否收录作品
	private Short webUpload;         //是否网页上传 1是 0不是
	private String hashCode;         //md5码
	private Short fileType;        //文件类型 1音频 4 视频
	private String fileURL;          //文件地址
	private String thumbUrl;         //缩略图
	private Float duration;          //时长
	private Float bitrate;           //码流（kb）
	private Long createTimeMills;  //创建时间
	private String createTimeByFormat; //格式化后的创建时间

	private Integer playTimes;       //播放次数
	private Integer praiseTimes;     //点赞次数
	private Integer shareTimes;      //分享次数
	private Integer commentTimes;    //评论次数
	private Integer collectTimes;    //收藏次数
	private Integer chorusNum;       //合唱次数
	private Long giftAmount;         //礼物数量
	private Long giftDiamond;        //礼物乐币数量
	private Integer flowerAmount;    //鲜花数量
	private Long redPacketAmount;   //红包数量

	private Long roomID;
	private String roomName;

	private Integer grade;
	private Long totalScore;
	private String cover;
	private Integer skipSecond;

	private Short goodVoice;           //好声音 1是 0否

	private String pendant;
	private String semiPendant;
	private String partnerPendant;

	private Short isReading = (short)0;

	private Integer activityId;      //活动ID
	private String activityName;    //活动名称

	private Integer topicId;         //话题
	private String topicName;        //话题名称

	private Integer kscSongID;       //曲库ID
	private String kscLink;          //字幕
	private String songSource;       //歌曲来源
	private String accompanyLink;    //伴奏ID
	private Integer artistID;        //歌手ID
	private String singerName;       //歌手名
	private Short vocalID;         //伴奏音轨
	private Short state;             //状态      
	private Short accompaniment_state; //伴奏版权
	private Short original_state;      //原唱版权

	private Short isMID = (short)0;
	private String MIDUrl;
	private Short songState;

	private Long userID;             //用户ID
	private String nickName;           //用户昵称
	private String userPhoto;          //用户头像
	private String gender;             //用户性别
	private Short authType;          //认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String authInfo;           //认证信息
	private Integer vip;               //是否会员  1是 0不是
	private Long level_singer;         //歌手等级
	
	private Long semiUserID;           //发起合唱用户ID
	private String semiNickName;       //发起合唱用户昵称
	private String semiGender;         //发起合唱性别
	private String semiUserPhoto;      //发起合唱用户头像
	private Short semiAuthType;      //发起合唱用户认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String semiAuthInfo;       //发起合唱用户认证信息
	private Integer semiVip;           //发起合唱用户是否会员  1是 0不是
	private Long semi_level_singer;    //发起合唱用户歌手等级
	
	private Long partnerUserID;        //合唱用户ID
	private String partnerNickName;    //合唱用户昵称
	private String partnerGender;      //合唱用户性别
	private String partnerUserPhoto;   //合唱用户头像
	private Short partnerAuthType;   //合唱认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String partnerAuthInfo;    //合唱用户认证信息
	private Integer partnerVip;        //合唱用户是否会员  1是 0不是
	private Long partner_level_singer;  //合唱用户歌手等级

</code></pre>
<pre><code>{
	&quot;topicList&quot;: [{
		&quot;totalScore&quot;: 0,
		&quot;redPacketAmount&quot;: 0,
		&quot;hashCode&quot;: &quot;c480c49370ff4bed62465c81bc62f2d7&quot;,
		&quot;createTimeMills&quot;: 1570774724000,
		&quot;activityId&quot;: -1,
		&quot;songSource&quot;: &quot;songdb&quot;,
		&quot;zpSource&quot;: 0,
		&quot;vip&quot;: 1,
		&quot;isReading&quot;: 0,
		&quot;cover&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aA7nuae2Unue.jpg&quot;,
		&quot;partnerUserID&quot;: 0,
		&quot;nickName&quot;: &quot;饭票_down今儿天不错哈哈哈&quot;,
		&quot;isMID&quot;: 0,
		&quot;description&quot;: &quot;&quot;,
		&quot;gender&quot;: &quot;F&quot;,
		&quot;frontCoverUrl&quot;: &quot;&quot;,
		&quot;topicName&quot;: &quot;测试话题&quot;,
		&quot;avid&quot;: 9998798,
		&quot;status&quot;: 2,
		&quot;semiUserID&quot;: 0,
		&quot;recordParams&quot;: &quot;{\&quot;recordedEqualizer\&quot;:3,\&quot;reverberationName\&quot;:\&quot;流行\&quot;,\&quot;recordingMusicEffect\&quot;:0,\&quot;deviceName\&quot;:\&quot;Android\&quot;,\&quot;voiceValue\&quot;:80,\&quot;accompanyValue\&quot;:80,\&quot;deviceType\&quot;:1,\&quot;recordingTune\&quot;:0,\&quot;headIconState\&quot;:false,\&quot;recordedTimbre\&quot;:0,\&quot;recordedMusicEffect\&quot;:3}&quot;,
		&quot;kscSongID&quot;: 90605881,
		&quot;topicId&quot;: 1,
		&quot;level_singer&quot;: 56,
		&quot;vocalID&quot;: 4,
		&quot;accompaniment_state&quot;: 1,
		&quot;flowerAmount&quot;: 0,
		&quot;kscLink&quot;: &quot;http://upcdn.song.m.mvbox.cn/ksc/90/81/90605881-1.ksc&quot;,
		&quot;userPhoto&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aA7nuae2Unue.jpg&quot;,
		&quot;state&quot;: 1,
		&quot;giftDiamond&quot;: 0,
		&quot;privateUpload&quot;: 0,
		&quot;name&quot;: &quot;默(电影《何以笙箫默》主题插曲)&quot;,
		&quot;grade&quot;: 0,
		&quot;collectTimes&quot;: 0,
		&quot;authType&quot;: 1,
		&quot;originalDescription&quot;: &quot;&quot;,
		&quot;chorusNum&quot;: 0,
		&quot;fileType&quot;: 1,
		&quot;skipSecond&quot;: 0,
		&quot;fileURL&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/c480c49370ff4bed62465c81bc62f2d7_900007007_1.m4a?useProxy=1&quot;,
		&quot;accompanyLink&quot;: &quot;http://upcdn.song.m.mvbox.cn/mka/81/90605881-1.mka&quot;,
		&quot;commentTimes&quot;: 0,
		&quot;playTimes&quot;: 2,
		&quot;webUpload&quot;: 0,
		&quot;createTimeByFormat&quot;: &quot;7分钟前&quot;,
		&quot;userID&quot;: 900007007,
		&quot;exFileType&quot;: 0,
		&quot;duration&quot;: 278.032,
		&quot;singerName&quot;: &quot;那英&quot;,
		&quot;original_state&quot;: 1,
		&quot;praiseTimes&quot;: 0,
		&quot;authInfo&quot;: &quot;&quot;,
		&quot;bitrate&quot;: 126.0,
		&quot;isAccept&quot;: 0,
		&quot;shareTimes&quot;: 0,
		&quot;giftAmount&quot;: 0,
		&quot;semiAVID&quot;: 0
	}],
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>24.10 话题精品作品列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/content/good.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/content/good.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题id</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>话题</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>话题作品列表</td><td>users</td><td>是</td><td>List</td><td>&nbsp;</td><td>显示20条</td></tr></tbody>
</table></figure>
<h5>作品对象</h5>
<pre><code class='language-java' lang='java'>
    private Long avid;               //作品ID
	private String name;             //作品名称
	private String frontCoverUrl;    //封面图片Url
	private String description;      //描述
	private String originalDescription;
	private Short exFileType;      //扩展文件类型 扩展文件类型 0 独唱 1 合唱 2 发起合唱
	private Long semiAVID;           //发起合唱作品ID
	private Short status;          //作品状态
	private Short zpSource;        //作品来源 0 翻唱曲库 1 清唱 2 本地歌曲
	private String recordParams;     //录歌参数
	private Short privateUpload;   //是否私密上传 1是 0不是
	private Short isAccept;          //是否收录作品
	private Short webUpload;         //是否网页上传 1是 0不是
	private String hashCode;         //md5码
	private Short fileType;        //文件类型 1音频 4 视频
	private String fileURL;          //文件地址
	private String thumbUrl;         //缩略图
	private Float duration;          //时长
	private Float bitrate;           //码流（kb）
	private Long createTimeMills;  //创建时间
	private String createTimeByFormat; //格式化后的创建时间

	private Integer playTimes;       //播放次数
	private Integer praiseTimes;     //点赞次数
	private Integer shareTimes;      //分享次数
	private Integer commentTimes;    //评论次数
	private Integer collectTimes;    //收藏次数
	private Integer chorusNum;       //合唱次数
	private Long giftAmount;         //礼物数量
	private Long giftDiamond;        //礼物乐币数量
	private Integer flowerAmount;    //鲜花数量
	private Long redPacketAmount;   //红包数量

	private Long roomID;
	private String roomName;

	private Integer grade;
	private Long totalScore;
	private String cover;
	private Integer skipSecond;

	private Short goodVoice;           //好声音 1是 0否

	private String pendant;
	private String semiPendant;
	private String partnerPendant;

	private Short isReading = (short)0;

	private Integer activityId;      //活动ID
	private String activityName;    //活动名称

	private Integer topicId;         //话题
	private String topicName;        //话题名称

	private Integer kscSongID;       //曲库ID
	private String kscLink;          //字幕
	private String songSource;       //歌曲来源
	private String accompanyLink;    //伴奏ID
	private Integer artistID;        //歌手ID
	private String singerName;       //歌手名
	private Short vocalID;         //伴奏音轨
	private Short state;             //状态      
	private Short accompaniment_state; //伴奏版权
	private Short original_state;      //原唱版权

	private Short isMID = (short)0;
	private String MIDUrl;
	private Short songState;

	private Long userID;             //用户ID
	private String nickName;           //用户昵称
	private String userPhoto;          //用户头像
	private String gender;             //用户性别
	private Short authType;          //认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String authInfo;           //认证信息
	private Integer vip;               //是否会员  1是 0不是
	private Long level_singer;         //歌手等级
	
	private Long semiUserID;           //发起合唱用户ID
	private String semiNickName;       //发起合唱用户昵称
	private String semiGender;         //发起合唱性别
	private String semiUserPhoto;      //发起合唱用户头像
	private Short semiAuthType;      //发起合唱用户认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String semiAuthInfo;       //发起合唱用户认证信息
	private Integer semiVip;           //发起合唱用户是否会员  1是 0不是
	private Long semi_level_singer;    //发起合唱用户歌手等级
	
	private Long partnerUserID;        //合唱用户ID
	private String partnerNickName;    //合唱用户昵称
	private String partnerGender;      //合唱用户性别
	private String partnerUserPhoto;   //合唱用户头像
	private Short partnerAuthType;   //合唱认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String partnerAuthInfo;    //合唱用户认证信息
	private Integer partnerVip;        //合唱用户是否会员  1是 0不是
	private Long partner_level_singer;  //合唱用户歌手等级

</code></pre>
<pre><code>{
	&quot;topicList&quot;: [{
		&quot;totalScore&quot;: 0,
		&quot;redPacketAmount&quot;: 0,
		&quot;hashCode&quot;: &quot;c480c49370ff4bed62465c81bc62f2d7&quot;,
		&quot;createTimeMills&quot;: 1570774724000,
		&quot;activityId&quot;: -1,
		&quot;songSource&quot;: &quot;songdb&quot;,
		&quot;zpSource&quot;: 0,
		&quot;vip&quot;: 1,
		&quot;isReading&quot;: 0,
		&quot;cover&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aA7nuae2Unue.jpg&quot;,
		&quot;partnerUserID&quot;: 0,
		&quot;nickName&quot;: &quot;饭票_down今儿天不错哈哈哈&quot;,
		&quot;isMID&quot;: 0,
		&quot;description&quot;: &quot;&quot;,
		&quot;gender&quot;: &quot;F&quot;,
		&quot;frontCoverUrl&quot;: &quot;&quot;,
		&quot;topicName&quot;: &quot;测试话题&quot;,
		&quot;avid&quot;: 9998798,
		&quot;status&quot;: 2,
		&quot;semiUserID&quot;: 0,
		&quot;recordParams&quot;: &quot;{\&quot;recordedEqualizer\&quot;:3,\&quot;reverberationName\&quot;:\&quot;流行\&quot;,\&quot;recordingMusicEffect\&quot;:0,\&quot;deviceName\&quot;:\&quot;Android\&quot;,\&quot;voiceValue\&quot;:80,\&quot;accompanyValue\&quot;:80,\&quot;deviceType\&quot;:1,\&quot;recordingTune\&quot;:0,\&quot;headIconState\&quot;:false,\&quot;recordedTimbre\&quot;:0,\&quot;recordedMusicEffect\&quot;:3}&quot;,
		&quot;kscSongID&quot;: 90605881,
		&quot;topicId&quot;: 1,
		&quot;level_singer&quot;: 56,
		&quot;vocalID&quot;: 4,
		&quot;accompaniment_state&quot;: 1,
		&quot;flowerAmount&quot;: 0,
		&quot;kscLink&quot;: &quot;http://upcdn.song.m.mvbox.cn/ksc/90/81/90605881-1.ksc&quot;,
		&quot;userPhoto&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aA7nuae2Unue.jpg&quot;,
		&quot;state&quot;: 1,
		&quot;giftDiamond&quot;: 0,
		&quot;privateUpload&quot;: 0,
		&quot;name&quot;: &quot;默(电影《何以笙箫默》主题插曲)&quot;,
		&quot;grade&quot;: 0,
		&quot;collectTimes&quot;: 0,
		&quot;authType&quot;: 1,
		&quot;originalDescription&quot;: &quot;&quot;,
		&quot;chorusNum&quot;: 0,
		&quot;fileType&quot;: 1,
		&quot;skipSecond&quot;: 0,
		&quot;fileURL&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/c480c49370ff4bed62465c81bc62f2d7_900007007_1.m4a?useProxy=1&quot;,
		&quot;accompanyLink&quot;: &quot;http://upcdn.song.m.mvbox.cn/mka/81/90605881-1.mka&quot;,
		&quot;commentTimes&quot;: 0,
		&quot;playTimes&quot;: 2,
		&quot;webUpload&quot;: 0,
		&quot;createTimeByFormat&quot;: &quot;7分钟前&quot;,
		&quot;userID&quot;: 900007007,
		&quot;exFileType&quot;: 0,
		&quot;duration&quot;: 278.032,
		&quot;singerName&quot;: &quot;那英&quot;,
		&quot;original_state&quot;: 1,
		&quot;praiseTimes&quot;: 0,
		&quot;authInfo&quot;: &quot;&quot;,
		&quot;bitrate&quot;: 126.0,
		&quot;isAccept&quot;: 0,
		&quot;shareTimes&quot;: 0,
		&quot;giftAmount&quot;: 0,
		&quot;semiAVID&quot;: 0
	}],
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>24.11 话题推荐作品列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/content/recommand.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/content/recommand.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题id</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>话题id</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>重置flag</td><td>reset_tag</td><td>否</td><td>Integer</td><td>1</td><td>当传递且为1时重置数据，标示首次进入刷新</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>话题作品列表</td><td>users</td><td>是</td><td>List</td><td>&nbsp;</td><td>显示20条</td></tr></tbody>
</table></figure>
<h5>作品对象</h5>
<pre><code class='language-java' lang='java'>
    private Long avid;               //作品ID
	private String name;             //作品名称
	private String frontCoverUrl;    //封面图片Url
	private String description;      //描述
	private String originalDescription;
	private Short exFileType;      //扩展文件类型 扩展文件类型 0 独唱 1 合唱 2 发起合唱
	private Long semiAVID;           //发起合唱作品ID
	private Short status;          //作品状态
	private Short zpSource;        //作品来源 0 翻唱曲库 1 清唱 2 本地歌曲
	private String recordParams;     //录歌参数
	private Short privateUpload;   //是否私密上传 1是 0不是
	private Short isAccept;          //是否收录作品
	private Short webUpload;         //是否网页上传 1是 0不是
	private String hashCode;         //md5码
	private Short fileType;        //文件类型 1音频 4 视频
	private String fileURL;          //文件地址
	private String thumbUrl;         //缩略图
	private Float duration;          //时长
	private Float bitrate;           //码流（kb）
	private Long createTimeMills;  //创建时间
	private String createTimeByFormat; //格式化后的创建时间

	private Integer playTimes;       //播放次数
	private Integer praiseTimes;     //点赞次数
	private Integer shareTimes;      //分享次数
	private Integer commentTimes;    //评论次数
	private Integer collectTimes;    //收藏次数
	private Integer chorusNum;       //合唱次数
	private Long giftAmount;         //礼物数量
	private Long giftDiamond;        //礼物乐币数量
	private Integer flowerAmount;    //鲜花数量
	private Long redPacketAmount;   //红包数量

	private Long roomID;
	private String roomName;

	private Integer grade;
	private Long totalScore;
	private String cover;
	private Integer skipSecond;

	private Short goodVoice;           //好声音 1是 0否

	private String pendant;
	private String semiPendant;
	private String partnerPendant;

	private Short isReading = (short)0;

	private Integer activityId;      //活动ID
	private String activityName;    //活动名称

	private Integer topicId;         //话题
	private String topicName;        //话题名称

	private Integer kscSongID;       //曲库ID
	private String kscLink;          //字幕
	private String songSource;       //歌曲来源
	private String accompanyLink;    //伴奏ID
	private Integer artistID;        //歌手ID
	private String singerName;       //歌手名
	private Short vocalID;         //伴奏音轨
	private Short state;             //状态      
	private Short accompaniment_state; //伴奏版权
	private Short original_state;      //原唱版权

	private Short isMID = (short)0;
	private String MIDUrl;
	private Short songState;

	private Long userID;             //用户ID
	private String nickName;           //用户昵称
	private String userPhoto;          //用户头像
	private String gender;             //用户性别
	private Short authType;          //认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String authInfo;           //认证信息
	private Integer vip;               //是否会员  1是 0不是
	private Long level_singer;         //歌手等级
	
	private Long semiUserID;           //发起合唱用户ID
	private String semiNickName;       //发起合唱用户昵称
	private String semiGender;         //发起合唱性别
	private String semiUserPhoto;      //发起合唱用户头像
	private Short semiAuthType;      //发起合唱用户认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String semiAuthInfo;       //发起合唱用户认证信息
	private Integer semiVip;           //发起合唱用户是否会员  1是 0不是
	private Long semi_level_singer;    //发起合唱用户歌手等级
	
	private Long partnerUserID;        //合唱用户ID
	private String partnerNickName;    //合唱用户昵称
	private String partnerGender;      //合唱用户性别
	private String partnerUserPhoto;   //合唱用户头像
	private Short partnerAuthType;   //合唱认证类型  -1未认证 0普通用户 1明星 2音乐人
	private String partnerAuthInfo;    //合唱用户认证信息
	private Integer partnerVip;        //合唱用户是否会员  1是 0不是
	private Long partner_level_singer;  //合唱用户歌手等级

</code></pre>
<pre><code>{
	&quot;topicList&quot;: [{
		&quot;totalScore&quot;: 0,
		&quot;redPacketAmount&quot;: 0,
		&quot;hashCode&quot;: &quot;c480c49370ff4bed62465c81bc62f2d7&quot;,
		&quot;createTimeMills&quot;: 1570774724000,
		&quot;activityId&quot;: -1,
		&quot;songSource&quot;: &quot;songdb&quot;,
		&quot;zpSource&quot;: 0,
		&quot;vip&quot;: 1,
		&quot;isReading&quot;: 0,
		&quot;cover&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aA7nuae2Unue.jpg&quot;,
		&quot;partnerUserID&quot;: 0,
		&quot;nickName&quot;: &quot;饭票_down今儿天不错哈哈哈&quot;,
		&quot;isMID&quot;: 0,
		&quot;description&quot;: &quot;&quot;,
		&quot;gender&quot;: &quot;F&quot;,
		&quot;frontCoverUrl&quot;: &quot;&quot;,
		&quot;topicName&quot;: &quot;测试话题&quot;,
		&quot;avid&quot;: 9998798,
		&quot;status&quot;: 2,
		&quot;semiUserID&quot;: 0,
		&quot;recordParams&quot;: &quot;{\&quot;recordedEqualizer\&quot;:3,\&quot;reverberationName\&quot;:\&quot;流行\&quot;,\&quot;recordingMusicEffect\&quot;:0,\&quot;deviceName\&quot;:\&quot;Android\&quot;,\&quot;voiceValue\&quot;:80,\&quot;accompanyValue\&quot;:80,\&quot;deviceType\&quot;:1,\&quot;recordingTune\&quot;:0,\&quot;headIconState\&quot;:false,\&quot;recordedTimbre\&quot;:0,\&quot;recordedMusicEffect\&quot;:3}&quot;,
		&quot;kscSongID&quot;: 90605881,
		&quot;topicId&quot;: 1,
		&quot;level_singer&quot;: 56,
		&quot;vocalID&quot;: 4,
		&quot;accompaniment_state&quot;: 1,
		&quot;flowerAmount&quot;: 0,
		&quot;kscLink&quot;: &quot;http://upcdn.song.m.mvbox.cn/ksc/90/81/90605881-1.ksc&quot;,
		&quot;userPhoto&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aA7nuae2Unue.jpg&quot;,
		&quot;state&quot;: 1,
		&quot;giftDiamond&quot;: 0,
		&quot;privateUpload&quot;: 0,
		&quot;name&quot;: &quot;默(电影《何以笙箫默》主题插曲)&quot;,
		&quot;grade&quot;: 0,
		&quot;collectTimes&quot;: 0,
		&quot;authType&quot;: 1,
		&quot;originalDescription&quot;: &quot;&quot;,
		&quot;chorusNum&quot;: 0,
		&quot;fileType&quot;: 1,
		&quot;skipSecond&quot;: 0,
		&quot;fileURL&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/c480c49370ff4bed62465c81bc62f2d7_900007007_1.m4a?useProxy=1&quot;,
		&quot;accompanyLink&quot;: &quot;http://upcdn.song.m.mvbox.cn/mka/81/90605881-1.mka&quot;,
		&quot;commentTimes&quot;: 0,
		&quot;playTimes&quot;: 2,
		&quot;webUpload&quot;: 0,
		&quot;createTimeByFormat&quot;: &quot;7分钟前&quot;,
		&quot;userID&quot;: 900007007,
		&quot;exFileType&quot;: 0,
		&quot;duration&quot;: 278.032,
		&quot;singerName&quot;: &quot;那英&quot;,
		&quot;original_state&quot;: 1,
		&quot;praiseTimes&quot;: 0,
		&quot;authInfo&quot;: &quot;&quot;,
		&quot;bitrate&quot;: 126.0,
		&quot;isAccept&quot;: 0,
		&quot;shareTimes&quot;: 0,
		&quot;giftAmount&quot;: 0,
		&quot;semiAVID&quot;: 0
	}],
	&quot;retCode&quot;: 1000
}

</code></pre>
<h3>24.12 顶部用户列表</h3>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/topic/user/index.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/user/index.htm?parameter=</a>{...}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>topicId</td><td>topicId</td><td>是</td><td>Integer</td><td>15</td><td>每页的长度</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 1005 操作失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>活跃用户列表</td><td>topicList</td><td>是</td><td>List</td><td>&nbsp;</td><td>显示5条</td></tr><tr><td>活跃用户列表</td><td>topicUserCount</td><td>是</td><td>int</td><td>&nbsp;</td><td>参与用户数</td></tr></tbody>
</table></figure>
<pre><code class='language-java' lang='java'>private Long userId;						//用户ID
private String nickName;				//用户昵称
private Long score;					//用户点赞数
private String photo;			//头像url
private String pendant          //封面
private Integer authType        //身份
</code></pre>
<pre><code>{
	&quot;topicList&quot;: {
		&quot;topicUserCount&quot;: 16,
		&quot;topicUsers&quot;: [{
			&quot;nickName&quot;: &quot;7852513哈哈天天&quot;,
			&quot;pendant&quot;: &quot;http://cdn.file.51vv.com/vvmobilelive/pendant/20190906.png&quot;,
			&quot;userId&quot;: 7852513,
			&quot;score&quot;: 10,
			&quot;authType&quot;: 2,
			&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aaERnmayei2Y.jpg&quot;
		}, {
			&quot;nickName&quot;: &quot;7852514&quot;,
			&quot;pendant&quot;: &quot;&quot;,
			&quot;userId&quot;: 7852514,
			&quot;score&quot;: 4,
			&quot;authType&quot;: 5,
			&quot;photo&quot;: &quot;http://upcdn.file.m.mvbox.cn/3/aIrIrqifuYbQ.jpg&quot;
		}]
	},
	&quot;retCode&quot;: 1000
}

</code></pre>
<h5>活跃用户对象</h5>
<pre><code class='language-java' lang='java'>private Long userId;						//伴奏id
private String userName;				//伴奏曲名
private Long userScore;					//用户评分
private String portraitUrl;			//头像url
</code></pre>
<h3>25.1 官赛改版，热度赛。我的作品列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/myHotAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/myHotAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				NAME: ,--作品名称
				userid: ,--用户id
				CreateTime:,
				userPhoto:,--用户头像
				nickName:,--用户昵称
				hot:,--作品热度
				flower:	 --作品鲜花数
				rank:--名次
			}
		],
	retCode: 1000
}

</code></pre>
<h3>25.2 官赛改版，热度赛。我的作品列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/myFlowerAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/myFlowerAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>返回结果</td><td>retMsg</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				NAME: ,--作品名称
				userid: ,--用户id
				CreateTime:,
				userPhoto:,--用户头像
				nickName:,--用户昵称
				hot:,--作品热度
				flower:	 --作品鲜花数
				rank:--名次
			}
		],
	retCode: 1000
}

</code></pre>
<h3>25.3 官赛改版,人气赛,端内投票接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/vote.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/vote.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>投票设备类型</td><td>clientType</td><td>是</td><td>Short</td><td>1</td><td>投票设备类型:1是端内投票，2是小程序投票</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>投票结果</td><td>voteResult</td><td>是</td><td>int</td><td>&nbsp;</td><td>投票成功：1，非1是投票失败</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;&#39;,
	voteResult:1,
    msg:&#39;&#39; //投票的提示
}

</code></pre>
<h3>25.4 官赛改版,人气赛,小程序投票接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/miniVote.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/miniVote.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>投票设备类型</td><td>clientType</td><td>是</td><td>Short</td><td>1</td><td>投票设备类型:1是端内投票，2是小程序投票</td></tr><tr><td>小程序的cid</td><td>cid</td><td>是</td><td>String</td><td>&nbsp;</td><td>cid</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>投票结果</td><td>voteResult</td><td>是</td><td>int</td><td>&nbsp;</td><td>投票成功：1，非1是投票失败</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;&#39;,
	voteResult:1,
    msg:&#39;&#39; //投票的提示
}

</code></pre>
<h3>25.5 官赛改版,人气赛,是否对某一个作品已经投过票</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/checkVoteState.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/checkVoteState.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>投票设备类型</td><td>clientType</td><td>是</td><td>Short</td><td>1</td><td>投票设备类型:1是端内投票，2是小程序投票</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>是否已投过</td><td>isVote</td><td>是</td><td>int</td><td>&nbsp;</td><td>1：已投过 ，0未投过</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;success&#39;,
	isVote:1
}

</code></pre>
<h3>25.6 官赛改版,人气赛,是否显示投票的的入口</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/showVote.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/showVote.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>作品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>是否显示投票入口</td><td>showVote</td><td>是</td><td>int</td><td>&nbsp;</td><td>1：显示 ，0不显示</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;success&#39;,
	voteResult:1
}

</code></pre>
<h3>25.7 官赛改版,人气赛,人气榜列表</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/popularityList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/popularityList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				Name: ,--作品名称
				userid: ,--用户id
				CreateTime:,--作品发布时间
				userPhoto:,--用户头像
				nickName:,--用户昵称
				Popularity:,--人气
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>25.8 官赛改版,人气赛,我的人气榜作品列表</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/myPopulAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/myPopulAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				Name: ,--作品名称
				userid: ,--用户id
				CreateTime:,--作品发布时间
				userPhoto:,--用户头像
				nickName:,--用户昵称
				Popularity:,--人气
				rank:--名次
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>25.9 官赛改版,人气赛,金话筒列表</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/goldMicAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/goldMicAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				Name: ,--作品名称
				userid: ,--用户id
				CreateTime:,--作品发布时间
				userPhoto:,--用户头像
				nickName:,--用户昵称
				Popularity:,--人气
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>25.10 官赛改版,人气赛,我的金话筒作品列表</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/myGoldMicAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/myGoldMicAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				Name: ,--作品名称
				userid: ,--用户id
				CreateTime:,--作品发布时间
				userPhoto:,--用户头像
				nickName:,--用户昵称
				Popularity:,--人气
				rank:--名次
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>25.11 官赛改版,人气赛,我支持的参赛作品接口</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/mySupportAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/mySupportAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				Name: ,--作品名称
				userid: ,--用户id
				CreateTime:,--作品发布时间
				userPhoto:,--用户头像
				nickName:,--用户昵称
				Popularity:,--人气
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>25.12 官赛改版,人气赛,搜索参赛作品接口</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/searchAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/searchAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>关键字</td><td>keyword</td><td>是</td><td>String</td><td>&quot;关键字&quot;</td><td>搜索关键字</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr><tr><td>活动类型</td><td>type</td><td>是</td><td>Integer</td><td>1</td><td>1人气赛  2热度赛</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				AVID: ,--作品id
				FileType: ,--作品类型
				Name: ,--作品名称
				userid: ,--用户id
				CreateTime:,--作品发布时间
				userPhoto:,--用户头像
				nickName:,--用户昵称
				Popularity:,--人气  人气赛返回
				hot:,--热度值      热度赛返回
				flower:,--鲜花数    热度赛返回
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>25.13 官赛改版,加入鲜花赛（需登录）</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/joinFlowerMatch.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/joinFlowerMatch.htm?parameter=</a>{activityID:2874,avID:10000467}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>10000467</td><td>作品ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>操作结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>操作提示语</td><td>msg</td><td>是</td><td>String</td><td>&nbsp;</td><td>加入鲜花赛失败</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: 1,  //1是成功，非1是失败，具体失败原因，看msg
	retCode: 1000,
	retMsg: &quot;系统处理成功&quot;,
	msg: &quot;加入鲜花赛成功&quot;
}

</code></pre>
<h3>25.14 鲜花赛，鲜花榜列表（无需登录）</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/flowerMatchAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/flowerMatchAvList.htm?parameter=</a>{activityID:2874}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>10000467</td><td>作品ID</td></tr><tr><td>活动ID</td><td>activityID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>鲜花榜列表</td><td>result</td><td>是</td><td>如下</td><td>JSON</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
result: [
{
	AVID: 10000467,
	Name: &quot;爱到深处全是泪&quot;,
	nickName: &quot;CY_大西瓜&quot;,
	FileType: 1,
	CreateTime: 1573635076000,
	userid: 900002773,
	userPhoto: &quot;http://file.m.mvbox.cn/upload/mobile/userPhoto/18/07/16/180716144818c269a57f6cdd42fd_300.jpg&quot;,
	flower: 67
}
],
retCode: 1000,
retMsg: &quot;success&quot;
}

</code></pre>
<h3>25.15 鲜花赛，我的作品列表（需登录）</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/mySpaceAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/mySpaceAvList.htm?parameter=</a>{activityID:2874}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>我的作品列表</td><td>result</td><td>是</td><td>如下</td><td>JSON</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
result: [
	{
		AVID: 10000467,			//作品ID
		Name: &quot;爱到深处全是泪&quot;,  //作品名
		rank: &quot;1&quot;,				//名次
		nickName: &quot;CY_大西瓜&quot;,
		FileType: 1,
		CreateTime: 1573635076000,
		userid: 900002773,
		userPhoto: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/07/16/180716144818c269a57f6cdd42fd_300.jpg&quot;,
		flower: 67			//鲜花数
	}
],
retCode: 1000,
retMsg: &quot;success&quot;
}

</code></pre>
<h3>25.16 鲜花赛，是否限制参赛（需登录）</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/limitEnterMatch.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/limitEnterMatch.htm?parameter=</a>{activityID:2874}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>是否限制参赛</td><td>result</td><td>是</td><td>int</td><td>0</td><td>0是不限制参赛，1是限制参赛</td></tr><tr><td>限制参赛原因</td><td>msg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: 0,
	retCode: 1000,
	retMsg: &quot;success&quot;,
	msg: &quot;&quot;
}

</code></pre>
<h3>25.17 2019年度盛典，比赛列表（无需登录）</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/year2019MatchList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/year2019MatchList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>比赛列表</td><td>result</td><td>是</td><td>JSON</td><td>如下</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
result: [
	{
	activityId: 1,										//比赛ID
	cover: &quot;space/discover/15/05/1432604909142.jpg&quot;,	//比赛封面
	smallType: 0,
	matchName: &quot;和你一起唱&quot;,								//比赛名
	type: 0
	}
],
	retCode: 1000,
	retMsg: &quot;success&quot;
}

</code></pre>
<h3>25.18 鲜花赛，选择我的作品列表</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/selectAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/selectAvList.htm?parameter=</a>{activityID:2874}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>我的作品列表</td><td>result</td><td>是</td><td>JSON</td><td>如下</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
result: [
	{
		activityId: -1,				
		FileSize: 496838,
		Name: &quot;你是我的人(DJ版)&quot;,		//作品名称
		AVID: 10000458,
		Status: 0,
		exFileType: 0,
		Description: &quot;&quot;,
		Tag: &quot;&quot;,
		CreateTime: 1573634083000,
		FileType: 1,
		UserID: 900002773,
		FileURL: &quot;/upload/36a7137741f815cc6df2b81452d4a06a_900002773_1.m4a&quot;,//作品地址
		frontCoverUrl: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/             userPhoto/18/07/16/180716144818c269a57f6cdd42fd.jpg&quot;//作品封面
	}
],
retCode: 1000,
retMsg: &quot;success&quot;
}

</code></pre>
<h3>25.19 是否有我的奖励</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/avRewardOpen.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/avRewardOpen.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>投票结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否显示我的奖励：1是显示，非1是不显示</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;&#39;,
	result:1
}

</code></pre>
<h3>25.19 是否有我的奖励</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/avRewardOpen.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/avRewardOpen.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>投票结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否显示我的奖励：1是显示，非1是不显示</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;&#39;,
	result:1
}

</code></pre>
<h3>25.20 官赛，我的奖励情况</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/official/avRewardList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/official/avRewardList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>投票结果</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>是否显示我的奖励：1是显示，非1是不显示</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	retCode: 1000,
	retMsg：&#39;success&#39;,
	lastTime:24342432131,
	diamond:1,
	flower:55,
	vip:1,
	mapList:[{
		&quot;listType&quot;:1,
		&quot;rank&quot;:1

		}
	]
}

</code></pre>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3>26.1 发歌抽奖活动,活动广场固定入口信息查询</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/enterInfo.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/enterInfo.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>广场入口信息</td><td>homePicture</td><td>否</td><td>String</td><td>&nbsp;</td><td>retCode为1000时返回</td></tr></tbody>
</table></figure>
<h3>26.2 发歌抽奖活动，在线活动列表查询</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/activityList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/activityList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>活动列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: [
			{
				id: ,--活动id
				name: ,--活动名称
				onlineTime: ,--上线时间
				lotteryTime: ,--开奖时间
				offlineTime:,--下线时间
				signUpTime:,--报名截止时间
				type:,--活动类型  默认0 全部参与  1限定曲目
				scoreRequire:,--评分要求 默认0不走评分
				lotteryNum:,--中奖名额
				giftType:,--奖品类型  默认0实物 1坐骑 2鲜花
				giftNum:,--奖品数量
				giftName:,--奖品名称
				giftContent:,--奖品补充文案
				sharePicture:,--分享图片
				shareTitle:,--分享标题
				shareContent:,--分享文案
				shareChannel:,--分享途径 默认都支持0微信朋友圈 1微信好友 2VV好友 3VV朋友圈
				giftPicture:,--奖励主图
				giftDescribe:,--奖励描述  json格式
				adsensePicture:,--活动聚合页奖品图片
				awardTime:,--发奖时间
				isAward:,--活动阶段，0和1未开奖，2已发奖
				joinCount:,--参加活动人数
				myJoinStatus:,--用户是否参加此活动
				adsenseTitle:,--聚合页标题
				detailBackdropPic:--详情页背景图
			}
		],
	retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>26.3 发歌抽奖活动，某个活动详情</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/activityDetails.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/activityDetails.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>活动详情</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
				id: ,--活动id
				name: ,--活动名称
				onlineTime: ,--上线时间
				lotteryTime: ,--开奖时间
				offlineTime:,--下线时间
				signUpTime:,--报名截止时间
				type:,--活动类型  默认0 全部参与  1限定曲目
				scoreRequire:,--评分要求 默认0不走评分
				lotteryNum:,--中奖名额
				giftType:,--奖品类型  默认0实物 1坐骑 2鲜花
				giftNum:,--奖品数量
				giftName:,--奖品名称
				giftContent:,--奖品补充文案
				sharePicture:,--分享图片
				shareTitle:,--分享标题
				shareContent:,--分享文案
				shareChannel:,--分享途径 默认都支持0微信朋友圈 1微信好友 2VV好友 3VV朋友圈
				giftPicture:,--奖励主图
				giftDescribe:,--奖励描述  json格式
				adsensePicture:,--活动聚合页奖品图片
				awardTime:,--发奖时间
				isAward:,--活动阶段，0和1未开奖，2已发奖
				awardDownTime:开奖倒计时,
				joinCount:参赛人数,
				spaceAvName:&quot;作品名&quot;,
				nickName:用户昵称,
				userPhoto:头像,
				winStatus：是否中奖,
				myJoinStatus:是否参加活动,
				avCover:作品封面,
      			adsenseTitle:聚合页标题,
				detailBackdropPic:详情页背景图
			},
	retCode: 1000,
	retMsg：&#39;success&#39;

}

</code></pre>
<h3>26.4 发歌抽奖活动，参赛作品列表查询</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/activityAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/activityAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>50</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>作品列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
				avID: ,--作品id
				name: ,--作品名称
				frontCoverUrl: ,--封面
				fileURL: ,--作品地址
				createTime:,--参加活动时间
				Nickname:,--用户昵称
				userPhoto:,--用户头像
			},
	retCode: 1000,
	retMsg：&#39;success&#39;

}

</code></pre>
<h3>26.5 发歌抽奖活动，用户作品列表查询</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/userSpaceAvList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/userSpaceAvList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>作品列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
				AVID: ,--作品id
				UserID: ,--用户id
				Name: ,--作品名称
				frontCoverUrl: ,--封面图片Url
				Tag:,--标签
				Description:,--描述
				FileType:,--文件类型 1 原创 2 翻唱 3 伴奏 4 视频
				FileURL: ,--文件地址
				FileSize:,--文件尺寸
				FromIP:,--来源IP
				Tag:,--标签
				Description:,--描述
				FileType:,--文件类型 1 原创 2 翻唱 3 伴奏 4 视频
				activityId：,活动ID
				privateUpload：,是否私密上传
				duration：,时长
				availStatus：,能否参加活动，0不能 1能
				noAvailDetail：,不能参数原因
				
			},
    retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>26.6 发歌抽奖活动，用户参加发歌抽奖活动</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/attendCjActivity.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/attendCjActivity.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr><tr><td>作品ID</td><td>avID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr></tbody>
</table></figure>
<h3>26.7 发歌抽奖活动，中奖名单列表查询</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/awardList.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/awardList.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>中奖名单列表</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
				avID: ,--作品id
				UserID: ,--用户id
				Nickname: ,--用户昵称
				photo1: ,--用户头像
				name:,--作品名称
			},
    retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>26.8 发歌抽奖活动，查询收集的用户信息</h3>
<h5>接口作者：童健</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/getUserInfo.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/getUserInfo.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>活动ID</td><td>activityID</td><td>是</td><td>long</td><td>&nbsp;</td><td>活动ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>用户信息</td><td>result</td><td>是</td><td>object</td><td>&nbsp;</td><td>不为空时返回</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
				userID: ,--用户id
				name: ,--用户名称
				identityNum: ,--身份证号码
				phoneNum: ,--手机
				address:,--收件地址
				isRealName:,--是否实名
				createTime:,--收集时间
			},
    retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>26.10 发歌抽奖活动，收集的用户信息</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/collectUserInfo.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/collectUserInfo.htm?parameter=</a>{}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>用户姓名</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>用户姓名</td></tr><tr><td>身份证号</td><td>identityNum</td><td>是</td><td>String</td><td>&nbsp;</td><td>身份证号</td></tr><tr><td>手机号</td><td>phoneNum</td><td>是</td><td>String</td><td>&nbsp;</td><td>手机号</td></tr><tr><td>地址</td><td>address</td><td>是</td><td>String</td><td>&nbsp;</td><td>地址</td></tr><tr><td>是否实名</td><td>isRealName</td><td>是</td><td>long</td><td>&nbsp;</td><td>是否实名</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>操作结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>收集成功：1，失败：0</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: 1
    retCode: 1000,
	retMsg：&#39;success&#39;
}

</code></pre>
<h3>26.11 发歌抽奖活动，获取权重值最大的比赛</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/songCj/getMaxWeightActivity.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/songCj/getMaxWeightActivity.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr><tr><td>操作结果</td><td>result</td><td>是</td><td>JSON</td><td>JSON</td><td>如下</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: {
		spaceCjActivity: {
		createTime: 1573537853000,
		weight: 11,
		adsenseTitle: &quot;&quot;,
		giftType: 0,
		lotteryNum: 1,
		shareTitle: &quot;咩咩咩中奖啦！都来沾沾我的运气吧&quot;,//分享标题
		isAdsense: 1,
		type: 1,
		configID: -1,
		shareContent: &quot;今日份K歌打卡 专业麦克风好礼拿回家！&quot;,//分享内容
		id: 2840,
		detailBackdropPic: &quot;&quot;,
		signUpTime: 1573624200000,
		lotteryTime: 1573624800000,
		name: &quot;今日份K歌打卡 专业麦克风好礼拿回家&quot;,
		giftName: &quot;VV音乐定制麦克风&quot;,
		giftContent: &quot;让你心动的专业唱歌直播设备&quot;,
		offlineTime: 1731945600000,
		giftNum: 0,
		homePicture: &quot;http://upcdn.file.m.mvbox.cn/upload/ga/image/d80a372a917c4607072381ce0d1250b5.jpg&quot;,
		shareChannel: &quot;0,1,2,3&quot;,//分享途径
		operateRank: 0,
		opUserID: 21216,
		isHomeAdsense: 1,
		updateTime: 1573611755000,
		status: 1,
		adsensePicture: &quot;http://upcdn.file.m.mvbox.cn/upload/ga/image/262da0d22a5e29564053611300c6714b.jpg&quot;,
		isGiftDescribe: 1,
		sharePicture: &quot;http://upcdn.file.m.mvbox.cn/upload/ga/image/262da0d22a5e29564053611300c6714b.jpg&quot;,//分享图片
		giftDescribe: &quot;[{&quot;type&quot;:1,&quot;value&quot;:&quot;http://upcdn.file.m.mvbox.cn/upload/ga/image/d965a4895971d091a35fd461aca88b50.jpg&quot;}]&quot;,
		isAward: 0,
		giftPoolID: 216,
		onlineTime: 1573537880000,
		scoreRequire: 80,
		joinCount: 3,
		isShareConfig: 1,
		giftPicture: &quot;http://upcdn.file.m.mvbox.cn/upload/ga/image/bd4010680d745b69116ccb6c528b4282.jpg&quot;
		}
	},
retCode: 1000,
retMsg: &quot;success&quot;
}

</code></pre>
<h3>27.1 家族管理接口(原查询家族接口 修改)</h3>
<h5>接口作者：温志广 、李旭(修改)</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/info/query.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/info/query.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>家族信息</td><td>family</td><td>是</td><td>Family</td><td>&nbsp;</td><td>家族信息</td></tr><tr><td>签到状况</td><td>sign</td><td>是</td><td>int</td><td>1</td><td>签到状况  1已签到 0未签到</td></tr><tr><td>是否展示活动申请链接</td><td>activityFlag</td><td>是</td><td>Boolean</td><td>ture</td><td>申请链接  true:展示 false:不展示</td></tr><tr><td><strong>是否展示家族成员作品投稿入口</strong></td><td>contributeDisplay</td><td>是</td><td>Boolean</td><td>true</td><td>是否展示：true:展示 false:不展示</td></tr><tr><td><strong>是否展示家族接待群入口</strong></td><td>familyGroupDisplay</td><td>是</td><td>Boolean</td><td>true</td><td>是否展示：true:展示 false:不展示</td></tr></tbody>
</table></figure>
<h5>家族模型 Family</h5>
<pre><code>    private Long familyID;      //家族ID
    private String name;        //家族名称
    private String notice;      //家族公告
    private String tag1;        //家族标签1
    private String tag2;        //家族标签2
    private String photo;       //家族头像
    private Long leader;        //家族长用户ID
    private Integer roomID;     //家族房间ID
    private Short roomState;    //家族房间状态 0未开通 1开通 2关闭
    private Short state;        //家族状态 0待审 1审核处理中 2审核通过 3审核不通过 4冻结 5解散 6关闭
    private Long score;         //家族积分
    private Long level;         //家族等级
    private Integer imgType;    //家族图片显示类型 1亮 0暗
    private Integer memberNum;  //家族人数
    private Integer workNum;    //家族作品数
    private Integer rank;       //家族排名
    private Long popularity;    //家族人气值
    private String roomName;    //房间名称
    private String roomCover;   //房间图片
    private Long onlineNum;     //房间在线人数
    private Long hotRank;       //热门排名 可空（2018年5月3日新增）
    private Long hotPopularity; //7天内发表的作品人气值 可空（2018年5月3日新增）
    
    private String newRoomName;	//新家族歌房名称，若没有开通过新家族歌房，默认&quot;&quot;
    private String newOnlineNum;//新家族歌房，在线人数，若没有开通过新家族歌房，默认&quot;&quot;
    private String newRoomStatus;//新家族歌房，房间状态，0 关闭（解散），1 开启。若没有开通过新家族歌房，默认&quot;&quot; 
    private String newRoomManageStatus;	//新家族歌房房间管理状态，0开通歌房后的默认值，4关停。
    private String newRoomCover;//新家族歌房图片，若没有开通过新家族歌房，默认&quot;&quot; 
    private Integer hasNewRoom;//是否有新歌房,0没有，1有
    private Long newRoomID;		//新歌房roomID
    private Short authAdvancedState;//家族高级认证状态 0未认证 1已认证
    private Short authState;//家族普通认证状态 0未认证 1已认证
    private String authStateLevel;//家族普通和高级认证的图标配置的key
    key对应配置接口里的allIcons的key(https://music.51vv.com/user/cfg/getCfgInfo.htm)
</code></pre>
<h3>27.2 家族投稿和个人投稿是否显示（修改：宋加彬）</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeDisplay.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeDisplay.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>投稿的作品ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族投稿是否显示</td><td>familyContribute</td><td>是</td><td>Integer</td><td>0</td><td>家族投稿是否展示 1:显示 0:不显示。</td></tr><tr><td>个人投稿是否显示</td><td>userContribute</td><td>是</td><td>Integer</td><td>0</td><td>个人投稿是否展示 1:显示 0:不显示。</td></tr><tr><td>家族投稿额度</td><td>familyContributeLimit</td><td>是</td><td>Integer</td><td>20</td><td>家族投稿剩余额度</td></tr><tr><td>上优选投稿额度</td><td>goodFamilyContributeLimit</td><td>是</td><td>Integer</td><td>20</td><td>推优家族投稿剩余额度(新版本后返回)</td></tr><tr><td>上首页投稿额度</td><td>reFamilyContributeLimit</td><td>是</td><td>Integer</td><td>20</td><td>推荐作品家族投稿剩余额度(新版本后返回)</td></tr><tr><td>个人投稿上优选是否显示</td><td>userGoodFlag</td><td>是</td><td>Integer</td><td>0</td><td>1:显示 0:不显示。(新版本后返回)</td></tr><tr><td>个人投稿上首页是否显示</td><td>userRecommendFlag</td><td>是</td><td>Integer</td><td>0</td><td>1:显示 0:不显示。(新版本后返回)</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.3 投稿</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contribute.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contribute.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>投稿的作品ID</td></tr><tr><td>投稿类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>投稿类型 0 个人-非金话筒 1 个人-金话筒 2 家族投稿</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>是否投稿成功 1:成功 0:失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.4 (金话筒)金话筒认证</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/goldMicrophone.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/goldMicrophone.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>goldMicrophone</td><td>是</td><td>GoldMicrophone</td><td>&nbsp;</td><td>金话筒认证信息</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>金话筒认证对象 GoldMicrophone</h5>
<h6>reviewedStatus为0</h6>
<pre><code>    private Integer reviewedStatus;                 //审核状态 0为未认证

    private Integer certificationOrNot;              //是否实名认证；1已认证，0未认证

    private Integer publicAVCount;                  //发布公开作品数量
    private Integer allPublicAVCount;               //所有发布公开作品数量

    private Integer recommendAVCount;               //首页推荐作品数量
    private Integer allRecommendAVCount;            //所有首页推荐作品数量

    private Integer reviewedAVCount;                //审核通过的投稿作品数量
    private Integer allReviewedAVCount;             //所有审核通过的投稿作品数量

</code></pre>
<h6>reviewedStatus为2</h6>
<pre><code>    private Integer reviewedStatus;                 //审核状态 2为已通过金话筒认证
    private Integer alertOrNot;                     //是否弹窗(一周未收到新歌)，0为不弹，1为弹

</code></pre>
<h6>reviewedStatus为1、3</h6>
<pre><code>    private Integer reviewedStatus;                 //审核状态 1为审核中，3为未通过金话筒认证

</code></pre>
<h3>27.5 (金话筒)申请金话筒认证校验</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/goldMicrophoneApplyCheck.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/goldMicrophoneApplyCheck.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.6 (金话筒)金话筒认证申请</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/goldMicrophoneApply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/goldMicrophoneApply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息</td><td>authenticationInfo</td><td>否</td><td>String</td><td>&nbsp;</td><td>认证信息，不能为空，最多15个字符</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.7 (金话筒)金话筒认证信息修改</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/goldAuthenticationAlter.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/goldAuthenticationAlter.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息审核状态</td><td>authenticationInfoStatus</td><td>是</td><td>Integer</td><td>0</td><td>认证信息审核状态,0为未审核，1为审核中，2为审核通过，3为审核失败</td></tr><tr><td>认证信息</td><td>authenticationInfo</td><td>是</td><td>Integer</td><td>0</td><td>认证信息</td></tr><tr><td>认证信息审核失败原因</td><td>authenticationInfoReason</td><td>是</td><td>String</td><td>&nbsp;</td><td>认证信息审核失败原因</td></tr><tr><td>返回结果</td><td>alterCount</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.8 (金话筒)金话筒认证信息修改申请</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/goldAuthenticationAlterApply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/goldAuthenticationAlterApply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息</td><td>authenticationInfo</td><td>否</td><td>String</td><td>&nbsp;</td><td>认证信息，不能为空，最多15个字符</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.9 (金话筒)投稿记录(最近7天的投稿记录)</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/latestContributeAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/latestContributeAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avList</td><td>是</td><td>ContributeAV</td><td>0</td><td>投稿作品信息</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>投稿作品对象 ContributeAV</h5>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面
    private Integer reviewedStatus;         //审核状态  0 未审核 1 审核通过 2 审核不通过
    private String reason;                  //未通过原因

</code></pre>
<h3>27.10 已投稿作品列表(最近30天)</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avList</td><td>是</td><td>ContributeAV</td><td>0</td><td>投稿作品信息</td></tr><tr><td>返回结果</td><td>contributeLimit</td><td>是</td><td>ContributeAV</td><td>0</td><td>剩余家族投稿额度</td></tr><tr><td>返回结果</td><td>canManageGoodVoice</td><td>是</td><td>ContributeAV</td><td>0</td><td>是否显示管理好声音,1显示，0不显示</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>投稿作品对象 ContributeAV</h5>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面
    private Long userID;                    //用户ID
    private String userName;                //用户昵称
    private String image;                   //用户头像
    private Date contributeDate;            //投稿日期
    private Integer reviewedStatus;         //审核状态  0 未审核 1 审核通过 2 审核不通过
    private String reason;                  //未通过原因

</code></pre>
<h3>27.11 已完成投稿成员</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeUserList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeUserList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>userList</td><td>是</td><td>ContributeUser</td><td>0</td><td>已完成投稿的用户</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code class='language-java' lang='java'>
    private Long userID;           //用户ID
    private String userName;       //用户昵称
    private String image;          //用户头像

</code></pre>
<h3>27.12 查询副家族长</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/assistantFamilyLeaderList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/assistantFamilyLeaderList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>副家族长列表</td><td>userList</td><td>是</td><td>ContributeUser</td><td>0</td><td>已完成投稿的用户</td></tr><tr><td>当前好声音负责人</td><td>currUser</td><td>是</td><td>ContributeUser</td><td>0</td><td>当前好声音负责人</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code class='language-java' lang='java'>
    private Long userID;           //用户ID
    private String userName;       //用户昵称
    private String image;          //用户头像

</code></pre>
<h3>27.13 设置好声音负责人</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/goodVoice.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/goodVoice.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>goodVoiceUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>是否投稿成功 1:成功 0:失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.14 解除好声音负责人</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/cancelGoodVoice.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/cancelGoodVoice.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户ID</td><td>goodVoiceUserID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>是否投稿成功 1:成功 0:失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.15 (金话筒)从未被投稿过的作品列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/neverContributeAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/neverContributeAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>最近一周投稿数量</td><td>contributeCount</td><td>是</td><td>Integer</td><td>0</td><td>最近一周投稿数量</td></tr><tr><td>每周投稿数量限制</td><td>contributeLimit</td><td>是</td><td>AV</td><td>0</td><td>每周投稿数量限制</td></tr><tr><td>是否是金话筒</td><td>goldMicrophoneOrNot</td><td>是</td><td>AV</td><td>0</td><td>是否是金话筒，1是，0否</td></tr><tr><td>返回结果</td><td>avList</td><td>是</td><td>AV</td><td>0</td><td>未投稿作品列表</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面

</code></pre>
<h3>27.16 (黄V)才艺认证</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/talentAndSkill.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/talentAndSkill.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<h5>reviewedStatus为0</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>0</td><td>审核状态</td></tr><tr><td>是否实名认证</td><td>certificationOrNot</td><td>是</td><td>Integer</td><td>0</td><td>是否实名认证，0未认证，1已认证</td></tr><tr><td>满足条件的作品</td><td>avCount</td><td>是</td><td>Integer</td><td>0</td><td>满足条件的作品数量</td></tr><tr><td>所有满足条件的作品</td><td>allAvCount</td><td>是</td><td>Integer</td><td>0</td><td>所有满足条件的作品数量</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>reviewedStatus为1</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>0</td><td>1为审核中</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>reviewedStatus为2</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>0</td><td>审核状态，2为审核成功</td></tr><tr><td>剩余修改次数</td><td>alterCount</td><td>是</td><td>Integer</td><td>1</td><td>剩余修改次数</td></tr><tr><td>当前认证信息</td><td>authenticationInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>当前认证信息</td></tr><tr><td>当前认证信息修改状态</td><td>authenticationInfoStatus</td><td>是</td><td>Integer</td><td>0</td><td>认证信息审核状态，0为未审核，1为审核中，2为审核通过，3为审核未通过</td></tr><tr><td>当前认证审核失败原因</td><td>authenticationInfoReason</td><td>是</td><td>String</td><td>&nbsp;</td><td>认证信息审核失败原因</td></tr><tr><td>是否是老黄V并弹窗</td><td>oldYellowAlert</td><td>是</td><td>Integer</td><td>1</td><td>是否是老黄V弹窗，是且只弹一次为1，其余为0</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>reviewedStatus为3</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>2</td><td>审核状态，3为审核失败</td></tr><tr><td>失败原因</td><td>reason</td><td>是</td><td>String</td><td>&nbsp;</td><td>审核失败原因</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.17 (黄V)才艺认证申请校验</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/talentAndSkillApplyCheck.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/talentAndSkillApplyCheck.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.18 (黄V)才艺认证申请</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/talentAndSkillApply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/talentAndSkillApply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息</td><td>authenticationInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>认证信息，黄V称号</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为申请成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.19 (黄V)修改才艺认证信息</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/alterTalentAndSkill.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/alterTalentAndSkill.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息</td><td>authenticationInfo</td><td>是</td><td>String</td><td>&nbsp;</td><td>认证信息，黄V称号</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为修改成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.20 (黄V)重新申请才艺认证</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/reapplyTalentAndSkill.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/reapplyTalentAndSkill.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为修改成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.21 (蓝V)机构认证</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/organization.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/organization.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<h5>reviewedStatus为0</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>0</td><td>审核状态，0为未认证</td></tr><tr><td>是否实名认证</td><td>certificationOrNot</td><td>是</td><td>Integer</td><td>0</td><td>是否实名认证，0未认证，1已认证</td></tr><tr><td>失败原因</td><td>reason</td><td>是</td><td>String</td><td>&nbsp;</td><td>审核失败原因</td></tr><tr><td>营业执照复印件</td><td>businessLicenseImage</td><td>是</td><td>String</td><td>&nbsp;</td><td>营业执照复印件</td></tr><tr><td>对接人委托书</td><td>entrustImage</td><td>是</td><td>String</td><td>&nbsp;</td><td>委托书</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>reviewedStatus为1、2</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>0</td><td>审核状态 1为审核中，2为审核成功</td></tr><tr><td>是否实名认证</td><td>certificationOrNot</td><td>是</td><td>Integer</td><td>0</td><td>是否实名认证，0未认证，1已认证</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>reviewedStatus为3</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>审核状态</td><td>reviewedStatus</td><td>是</td><td>Integer</td><td>0</td><td>审核状态 3为审核失败</td></tr><tr><td>是否实名认证</td><td>certificationOrNot</td><td>是</td><td>Integer</td><td>0</td><td>是否实名认证，0未认证，1已认证</td></tr><tr><td>失败原因</td><td>reason</td><td>是</td><td>String</td><td>&nbsp;</td><td>审核失败原因</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.22 (蓝V)机构认证申请校验</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/organizationApplyCheck.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/organizationApplyCheck.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>营业执照复印件</td><td>businessLicenseImage</td><td>是</td><td>String</td><td>&nbsp;</td><td>营业执照复印件</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.23 (蓝V)机构认证申请</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/organizationApply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/organizationApply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>营业执照复印件</td><td>businessLicenseImage</td><td>是</td><td>String</td><td>&nbsp;</td><td>营业执照复印件</td></tr><tr><td>对接人委托书</td><td>entrustImage</td><td>是</td><td>String</td><td>&nbsp;</td><td>委托书</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.24 (蓝V)机构认证信息修改</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/organizationAlter.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/organizationAlter.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息审核状态</td><td>authenticationInfoStatus</td><td>是</td><td>Integer</td><td>0</td><td>认证信息审核状态,0为未审核，1为审核中，2为审核通过，3为审核失败</td></tr><tr><td>认证信息</td><td>authenticationInfo</td><td>是</td><td>Integer</td><td>0</td><td>认证信息</td></tr><tr><td>认证信息审核失败原因</td><td>authenticationInfoReason</td><td>是</td><td>String</td><td>&nbsp;</td><td>认证信息审核失败原因</td></tr><tr><td>返回结果</td><td>alterCount</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.25 (蓝V)机构认证信息修改申请</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/organizationAlterApply.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/organizationAlterApply.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>认证信息</td><td>authenticationInfo</td><td>否</td><td>String</td><td>&nbsp;</td><td>认证信息，不能为空，最多15个字符</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.26 (蓝V)机构认证重新申请</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/reapplyOrganization.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/reapplyOrganization.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>结果，1为认证成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.27 上首页投稿</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeRecommend.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeRecommend.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>投稿的作品ID</td></tr><tr><td>投稿类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>投稿类型 1 个人投稿（金话筒，主诵） 2 家族投稿</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>是否投稿成功 1:成功 0:失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>toatMsg</td><td>否</td><td>String(128)</td><td>0</td><td>toatMsg提示</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>27.28 上首页家族已投稿作品列表</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeRecommendAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeRecommendAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avList</td><td>是</td><td>ContributeAV</td><td>0</td><td>投稿作品信息</td></tr><tr><td>返回结果</td><td>reFamilyContributeLimit</td><td>是</td><td>ContributeAV</td><td>0</td><td>剩余上首页家族投稿额度</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>投稿作品对象 ContributeAV</h5>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面
    private Long userID;                    //用户ID
    private String userName;                //用户昵称
    private String image;                   //用户头像
    private Date contributeDate;            //投稿日期
    private Integer reviewedStatus;         //审核状态  0 未审核 1 审核通过 2 审核不通过
    private String reason;                  //未通过原因

</code></pre>
<h3>27.29 投稿用户身份校验 是否显示上优 上首页按钮</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeUsercheck.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeUsercheck.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>个人投稿上优选是否显示</td><td>userGoodFlag</td><td>是</td><td>Integer</td><td>0</td><td>1:显示 0:不显示。</td></tr><tr><td>个人投稿上首页是否显示</td><td>userRecommendFlag</td><td>是</td><td>Integer</td><td>0</td><td>1:显示 0:不显示。</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>27.30 个人上优选 作品列表</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/findcontributeShareAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/findcontributeShareAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avList</td><td>是</td><td>AV</td><td>0</td><td>投稿作品信息</td></tr></tbody>
</table></figure>
<p>返回结果|retCode|是|int|1000|返回结果值,1000:成功
返回信息|retMsg|否|String(128)|success|参数格式错误</p>
<h5>投稿作品对象 AV</h5>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面
    private Long userID;                    //用户ID
    private String userName;                //用户昵称
    private String image;                   //用户头像

</code></pre>
<h3>27.31 个人上首页投稿作品列表</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/findcontributeRecommendAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/findcontributeRecommendAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avList</td><td>是</td><td>AV</td><td>0</td><td>投稿作品信息</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>投稿作品对象 AV</h5>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面
    private Long userID;                    //用户ID
    private String userName;                //用户昵称
    private String image;                   //用户头像


</code></pre>
<p>&nbsp;</p>
<h3>27.32 个人已投稿作品列表(30天内的)</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/findcontributePersonalAVList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/findcontributePersonalAVList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>avList</td><td>是</td><td>AV</td><td>0</td><td>投稿作品信息</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>投稿作品对象 AV</h5>
<pre><code class='language-java' lang='java'>
    private Long avID;                      //作品ID
    private String avName;                  //作品名称
    private String frontCoverUrl;           //作品封面
    private Long userID;                    //用户ID
    private String userName;                //用户昵称
    private String image;                   //用户头像
    private Date contributeDate;            //投稿日期
    private Integer reviewedStatus;         //审核状态  0 未审核 1 审核通过 2 审核不通过
    private String reason;                  //未通过原因
    private Short type;                     //投稿类型 1 优选投稿 2 首页投稿


</code></pre>
<h3>27.33 上优选投稿</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/authentication/contributeShare.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/authentication/contributeShare.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品ID</td><td>avID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>投稿的作品ID</td></tr><tr><td>投稿类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>投稿类型 0 个人-非金话筒 1 个人-金话筒 2 家族投稿</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>Integer</td><td>0</td><td>是否投稿成功 1:成功 0:失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>返回结果</td><td>toatMsg</td><td>否</td><td>String(128)</td><td>0</td><td>toatMsg提示</td></tr></tbody>
</table></figure>
<h3>28.1 发布图文</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/publish.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/publish.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>私密或公开</td><td>privateUpload</td><td>是</td><td>Integer</td><td>0</td><td>私密或公开，1是私密，0否</td></tr><tr><td>话题ID</td><td>topicId</td><td>否</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>文字信息</td><td>textInfo</td><td>否</td><td>String</td><td>&nbsp;</td><td>文字信息</td></tr><tr><td>图片信息</td><td>imageInfo</td><td>否</td><td>JsonArray</td><td>&nbsp;</td><td>图片信息,包括图片url，width,height</td></tr><tr><td>位置名称</td><td>location</td><td>否</td><td>String</td><td>&nbsp;</td><td>位置</td></tr><tr><td>详细地址</td><td>address</td><td>否</td><td>String</td><td>&nbsp;</td><td>详细地址</td></tr><tr><td>经度</td><td>lon</td><td>否</td><td>double</td><td>&nbsp;</td><td>经度</td></tr><tr><td>纬度</td><td>lat</td><td>否</td><td>double</td><td>&nbsp;</td><td>纬度</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>图文信息</td><td>tuwen</td><td>否</td><td>json</td><td>&nbsp;</td><td>刚发布的图文信息</td></tr></tbody>
</table></figure>
<h3>28.2 设为私密或公开</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/privateUpload.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/privateUpload.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文ID</td><td>tuwenId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>图文Id</td></tr><tr><td>私密或公开</td><td>privateUpload</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>私密或公开，1是私密，0否</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>返回更新条数，1为成功，0为失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.3 查看图文</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/detail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/detail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文ID</td><td>tuwenId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>图文Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>tuwen</td><td>是</td><td>Tuwen</td><td>0</td><td>图文对象</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>Tuwen对象</h5>
<pre><code>private Long tuwenId;               //图文Id
private Integer privateUpload;      //私密或公开，1为私密
private String textInfo;            //图文信息
private JsonArray imageInfo;        //图片信息
private Integer state;              //图文状态，1为正常，0为删除 2审核不通过
private Short removeType;           //图文删除类型，当state=0的时候用于区分自己删除还是官方删除 0自己删除 1官方删除
private String location;            //位置
private String address;            //地址
private Long topicId;               //话题Id
private Long topicName;             //话题名称
private String nickName;        //发布图文作者昵称
private String photo;           //发布图文作者头像
private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口
private String authInfo;        //认证信息
private Short vip;              //是否会员  1是 0否
private String publishTimeStr;        //发布时间字符串
private Integer commentNum;           //评论数
private Integer praiseNum;            //点赞数
private Integer shareNum;              //分享数
private Integer relation;   //当前登录用户和分享人的关系 0没关系 1关注 2好友 3被关注，当relation=0或者3的时候显示关注按钮
private Integer isPraised;

</code></pre>
<h3>28.4 删除图文</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/deleteTuwen.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/deleteTuwen.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文ID</td><td>tuwenId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>图文Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.5 删除动态</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/deleteMoments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/deleteMoments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>动态ID</td><td>dynamicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>动态Id</td></tr><tr><td>动态类型</td><td>dynamicType</td><td>是</td><td>Long</td><td>&nbsp;</td><td>动态类型</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.6 查询位置</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/location.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/location.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>搜索词</td><td>searchWord</td><td>否</td><td>String</td><td>&nbsp;</td><td>搜索词</td></tr><tr><td>经度</td><td>lon</td><td>否</td><td>double</td><td>&nbsp;</td><td>经度</td></tr><tr><td>纬度</td><td>lat</td><td>否</td><td>double</td><td>&nbsp;</td><td>纬度</td></tr><tr><td>第几页</td><td>curPage</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>页码</td><td>viewNumber</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>每页多少条，最多20条</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>位置信息列表</td><td>location</td><td>是</td><td>Location</td><td>&nbsp;</td><td>位置信息列表</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code>    private String location;        //位置
    private Double lon;             //经度
    private Double lat;             //纬度
    private String detailAddress;   //详细地址

</code></pre>
<h3>28.7、图文—评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/comment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/comment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr><tr><td>评论内容</td><td>content</td><td>是</td><td>string</td><td>哈哈</td><td>评论内容</td></tr><tr><td>父评论Id</td><td>parentId</td><td>否</td><td>long</td><td>0</td><td>父评论Id，默认0</td></tr><tr><td>回复消息类型</td><td>replyType</td><td>否</td><td>short</td><td>0</td><td>回复消息类型 0普通 2点赞 默认0</td></tr><tr><td>点赞Id</td><td>praiseId</td><td>否</td><td>Long</td><td>0</td><td>点赞Id replyType=2的时候必填</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>刚评论的内容</td><td>comment</td><td>否</td><td>json</td><td>&nbsp;</td><td>刚评论的内容</td></tr></tbody>
</table></figure>
<h5>图文评论模型 TuwenCommentCommonResult</h5>
<pre><code>private Long commentId;         //评论Id
private Short recordType;     //记录类型 1评论 2分享生成

private Long userId;            //评论人Id
private String nickName;        //评论人昵称
private String photo;           //评论人头像
private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口
private String authInfo;        //认证信息
private Short vip;              //是否会员  1是 0否

private Long tuwenId;           //图文Id
private String content;         //评论内容
private Long parentId;          //父评论
private Long rootParentId;      //根评论
private Short replyType;        //回复消息类型 0普通 2点赞
private Integer praiseNum;      //点赞数
private Long createTime;        //创建时间

private Long pUserId;            //父评论人Id
private String pNickName;        //父评论人昵称

private String createTimeStr;
</code></pre>
<h3>28.8、图文—删除评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/deleteComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/deleteComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文评论Id</td><td>commentId</td><td>是</td><td>long</td><td>100000</td><td>图文评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.9、图文-点赞</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/praise.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/praise.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.10、图文-取消点赞</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/deletePraise.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/deletePraise.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.11、图文-查看评论列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/queryComments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/queryComments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>评论列表</td><td>comments</td><td>是</td><td>jsonArray</td><td>&nbsp;</td><td>返回json格式的评论列表</td></tr></tbody>
</table></figure>
<h5>评论模型 TuwenComment</h5>
<pre><code>private Long commentId;         //评论Id
private Integer recordType;     //记录类型 1评论 2分享生成

private Long userId;            //评论人Id
private String nickName;        //评论人昵称
private String photo;           //评论人头像
private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口
private String authInfo;        //认证信息
private Short vip;              //是否会员  1是 0否

private Long tuwenId;           //图文Id
private String content;         //评论内容
private Long parentId;          //父评论
private Long rootParentId;      //根评论
private Short replyType;        //回复消息类型 0普通 2点赞
private Integer praiseNum;      //点赞数
private Long createTime;        //创建时间
private Integer subCommentsAmount; //二级评论数量

private List&lt;TuwenSubComment&gt; subComments; //前n条二级评论

private String createTimeStr;   //创建时间
private Integer isPraised;      //是否点赞
</code></pre>
<h3>28.12、图文-查看二级评论列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/querySubComments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/querySubComments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr><tr><td>一级评论Id</td><td>commentId</td><td>是</td><td>long</td><td>100000</td><td>一级评论Id</td></tr><tr><td>开始位置</td><td>beginIndex</td><td>否</td><td>Integer</td><td>20</td><td>开始位置</td></tr><tr><td>行数</td><td>rows</td><td>否</td><td>Integer</td><td>1</td><td>行数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>二级评论列表</td><td>subComments</td><td>是</td><td>jsonArray</td><td>&nbsp;</td><td>返回json格式的二级评论列表</td></tr><tr><td>二级评论数量</td><td>subCommentsAmount</td><td>否</td><td>Long</td><td>&nbsp;</td><td>二级评论数量</td></tr></tbody>
</table></figure>
<h5>二级评论模型 TuwenSubComment</h5>
<pre><code>private Long commentId;         //评论Id
private Integer recordType;     //记录类型 1评论 2分享生成

private Long userId;            //评论人Id
private String nickName;        //评论人昵称

private Long tuwenId;           //图文Id
private String content;         //评论内容
private Long parentId;          //父评论
private Long rootParentId;      //根评论
private Short replyType;        //回复消息类型 0普通 3分享
private Integer praiseNum;      //点赞数
private Long createTime;        //创建时间

private Long pUserId;            //父评论人Id
private String pNickName;        //父评论人昵称

private String createTimeStr;   //创建时间

</code></pre>
<h3>28.13、图文-三方分享</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/thirdShare.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/thirdShare.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr><tr><td>分享渠道</td><td>channel</td><td>否</td><td>short</td><td>100000</td><td>分享渠道 0未知 1微信 2微信朋友圈 3QQ  4QQ空间 5新浪微博 6腾讯微博 默认0</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.14、图文-点赞评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/praiseTuwenComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/praiseTuwenComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文评论Id</td><td>commentId</td><td>是</td><td>long</td><td>&nbsp;</td><td>图文评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.15、图文-点赞分享评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/praiseTuwenShareComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/praiseTuwenShareComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享评论Id</td><td>shareCommentId</td><td>是</td><td>long</td><td>&nbsp;</td><td>图文分享评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.16、图文分享-分享</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/share.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/share.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文Id</td><td>tuwenId</td><td>是</td><td>long</td><td>100000</td><td>图文Id</td></tr><tr><td>分享内容</td><td>content</td><td>否</td><td>String</td><td>&nbsp;</td><td>分享内容</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>result</td><td>是</td><td>int</td><td>1</td><td>返回结果 1成功，-1图文不存在，-2图文状态删除，-3图文私密，-4图文发布动态失败</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.17、图文分享-查看分享</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/queryShare.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/queryShare.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享Id</td><td>shareId</td><td>是</td><td>long</td><td>&nbsp;</td><td>图文分享Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>分享信息</td><td>share</td><td>是</td><td>jsonObject</td><td>&nbsp;</td><td>分享信息</td></tr></tbody>
</table></figure>
<h5>图文分享模型 TuwenShare</h5>
<pre><code>private Long shareId;    //分享Id
private String content;  //分享内容

private Long userId;            //评论人Id
private String nickName;        //评论人昵称
private String photo;           //评论人头像
private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口
private String authInfo;        //认证信息
private Short vip;              //是否会员  1是 0否

private Long tuwenId;       //图文Id
private Tuwen tuwen;        //图文信息
private Long createTime;    //分享时间

private Integer relation;   //当前登录用户和分享人的关系 0没关系 1关注 2好友 3被关注，当relation=0或者3的时候显示关注按钮
private String publishTimeStr;        //发布时间字符串
private Integer commentNum;           //评论数
private Integer praiseNum;            //点赞数

private Integer isPraised;      //是否点赞
</code></pre>
<h3>28.18、图文分享-评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/comment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/comment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享Id</td><td>shareId</td><td>是</td><td>long</td><td>100000</td><td>图文分享Id</td></tr><tr><td>评论内容</td><td>content</td><td>是</td><td>string</td><td>哈哈</td><td>评论内容</td></tr><tr><td>父评论Id</td><td>parentId</td><td>否</td><td>long</td><td>0</td><td>父评论Id，默认0</td></tr><tr><td>回复消息类型</td><td>replyType</td><td>否</td><td>short</td><td>0</td><td>回复消息类型 0普通 2点赞 默认0</td></tr><tr><td>点赞Id</td><td>sharePraiseId</td><td>否</td><td>Long</td><td>0</td><td>点赞Id replyType=2的时候必填</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>刚评论的内容</td><td>shareComment</td><td>否</td><td>json</td><td>&nbsp;</td><td>刚评论的内容</td></tr></tbody>
</table></figure>
<h5>图文分享评论模型 TuwenShareCommentCommonResult</h5>
<pre><code>private Long shareCommentId;    //评论Id
private Long userId;            //评论人Id
private String nickName;        //评论人昵称
private String photo;           //评论人头像
private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口
private String authInfo;        //认证信息
private Short vip;              //是否会员  1是 0否
private Long tuwenId;           //图文Id
private String content;         //评论内容
private Long parentId;          //父评论
private Long rootParentId;      //根评论
private Short replyType;        //回复消息类型 0普通 2点赞
private Integer praiseNum;      //点赞数
private Long createTime;        //创建时间
private Long pUserId;            //父评论人Id
private String pNickName;        //父评论人昵称

private String createTimeStr;

</code></pre>
<h3>28.19、图文分享-删除评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/deleteComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/deleteComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享评论Id</td><td>shareCommentId</td><td>是</td><td>long</td><td>&nbsp;</td><td>图文分享评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.20、图文分享-点赞</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/praise.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/praise.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享Id</td><td>shareId</td><td>是</td><td>long</td><td>100000</td><td>图文分享Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.21、图文分享-取消点赞</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/deletePraise.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/deletePraise.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享Id</td><td>shareId</td><td>是</td><td>long</td><td>100000</td><td>图文分享Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.22、图文分享-查看评论列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/queryComments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/queryComments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享Id</td><td>shareId</td><td>是</td><td>long</td><td>100000</td><td>图文分享Id</td></tr><tr><td>页长</td><td>viewNumber</td><td>否</td><td>Integer</td><td>15</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>否</td><td>Integer</td><td>1</td><td>当前页</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享评论列表</td><td>shareComments</td><td>是</td><td>jsonArray</td><td>&nbsp;</td><td>返回json格式的图文分享评论列表</td></tr></tbody>
</table></figure>
<h5>评论模型 TuwenShareComment</h5>
<pre><code>private Long shareCommentId;    //评论Id
private Integer recordType;     //记录类型 1评论 2分享生成

private Long userId;            //评论人Id
private String nickName;        //评论人昵称
private String photo;           //评论人头像
private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口
private String authInfo;        //认证信息
private Short vip;              //是否会员  1是 0否

private Long tuwenId;           //图文Id
private String content;         //评论内容
private Long parentId;          //父评论
private Long rootParentId;      //根评论
private Short replyType;        //回复消息类型 0普通 2点赞
private Integer praiseNum;      //点赞数
private Long createTime;        //创建时间
private Integer subCommentsAmount; //二级评论数量

private List&lt;TuwenSubShareComment&gt; subComments; //前n条二级评论

private Integer isPraised;       //是否点赞
private String createTimeStr;    //创建时间
</code></pre>
<h3>28.23、图文分享-查看二级评论列表</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/share/querySubComments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/share/querySubComments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享Id</td><td>shareId</td><td>是</td><td>long</td><td>100000</td><td>图文分享Id</td></tr><tr><td>一级评论Id</td><td>shareCommentId</td><td>是</td><td>long</td><td>100000</td><td>一级评论Id</td></tr><tr><td>开始位置</td><td>beginIndex</td><td>否</td><td>Integer</td><td>20</td><td>开始位置</td></tr><tr><td>行数</td><td>rows</td><td>否</td><td>Integer</td><td>1</td><td>行数</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>以下字段在retCode为1000的时候有返回</h5>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>二级图文分享评论列表</td><td>subShareComments</td><td>是</td><td>jsonArray</td><td>&nbsp;</td><td>返回json格式的二级图文分享评论列表</td></tr><tr><td>二级评论数量</td><td>subCommentsAmount</td><td>否</td><td>Long</td><td>&nbsp;</td><td>二级评论数量</td></tr></tbody>
</table></figure>
<h5>评论模型 TuwenSubShareComment</h5>
<pre><code>private Long shareCommentId;         //评论Id
private Integer recordType;     //记录类型 1评论 2分享生成

private Long userId;            //评论人Id
private String nickName;        //评论人昵称

private Long tuwenId;           //图文Id
private String content;         //评论内容
private Long parentId;          //父评论
private Long rootParentId;      //根评论
private Short replyType;        //回复消息类型 0普通 3分享
private Integer praiseNum;      //点赞数
private Long createTime;        //创建时间

private Long pUserId;            //父评论人Id
private String pNickName;        //父评论人昵称

private String createTimeStr;    //创建时间
</code></pre>
<h3>28.24 图文-获取图文举报类型</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/getReportType.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/getReportType.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>举报的相关类型</td><td>type</td><td>否</td><td>Integer</td><td>1</td><td>举报的相关类型，默认传1(动态的举报类型)</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr><tr><td>举报类型</td><td>reportTypes</td><td>否</td><td>JSONArray</td><td>&nbsp;</td><td>举报类型</td></tr></tbody>
</table></figure>
<pre><code>    private Integer reportTypeId;           //举报类型Id
    private String reportTypeName;          //举报类型名称

</code></pre>
<h3>28.25 图文-图文举报</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/report.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/report.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>动态ID</td><td>dynamicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>动态Id</td></tr><tr><td>举报对象类型ID</td><td>reportObjectType</td><td>是</td><td>Integer</td><td>1</td><td>举报对象类型，1为图文，2为转发图文</td></tr><tr><td>举报理由</td><td>type</td><td>是</td><td>Integer</td><td>1</td><td>举报理由:类型：1为色情低俗，2为广告骚扰，3为政治敏感，4为诽谤辱骂，5为散步谣言，6为欺诈骗钱，7为透露他人隐私，8为违法(暴力、违禁品)</td></tr><tr><td>举报描述</td><td>reportDesc</td><td>是</td><td>String</td><td>&nbsp;</td><td>举报描述</td></tr><tr><td>举报截图</td><td>reportImageInfo</td><td>是</td><td>JSONArray</td><td>&nbsp;</td><td>举报截图,图片url的JSON数组</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>28.26 图文-记录图文访客</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/recordVisitors.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/recordVisitors.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>对象ID</td><td>objID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>对象ID</td></tr><tr><td>图文类型</td><td>objType</td><td>是</td><td>Short</td><td>&nbsp;</td><td>1为图文，2为分享图文</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<h3>28.27 图文-查看图文访客</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/queryVisitors.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/queryVisitors.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>排序序号</td><td>sortNo</td><td>是</td><td>String</td><td>&nbsp;</td><td>分页用排序序号，每次取最后一个对象的sortNo</td></tr><tr><td>页码</td><td>pageSize</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>总条数</td><td>totalCount</td><td>是</td><td>int</td><td>1</td><td>总条数</td></tr><tr><td>结果集对象</td><td>visitorList</td><td>是</td><td>int</td><td>1000</td><td>返回图文访客对象</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>List<MyVisitorResult>对象</h5>
<pre><code>    private Long objID;

    private Integer objType;  //对象类型 1为作品，2为图文，3为分享图文

    private Date updateTime;

    private String sortNo;

    private String updateTimeFormatStr;

    private Long userID;       //访客用户ID

    private String nickName;   //访客昵称

    private String photo1;     //访客头像

    private Integer level;     //访客等级

    private Integer vip;

    private String listenFrom;    //听一听来源 1推荐 2才艺 3推优 4全国榜 5地区榜

    private SpaceAvVisitor spaceAvVisitor;

    private TuwenResult tuwenResult;

    private TuwenShareResult tuwenShareResult;

    private VvArticleResult vvArticle;

</code></pre>
<h5>SpaceAvVisitor对象</h5>
<pre><code>    private Long visitorID;    //听众ID
    private Long AVID;         //音视频ID
    private Integer source;    //访问refer(无效) 0 未知的 1 网友作品播放器
    private Date createTime;   //第一次试听时间
    private Date updateTime;   //最近一次试听时间

    private String name;          //作品名称
    private Short status;         //作品状态 0初始 2审核通过 4审核不通过或者被删除
    private Short fileType;       //作品类型  1音频 4视频
    private Short exFileType;     //作品扩展类型 0曲库 1合唱 2发表合唱
    private Short zpSource;       //0曲库 1清唱 2本地歌曲
    private String fileUrl;       //文件路径
    private String fileDomain;
    private Integer playTimes;    //播放次数
    private Integer addPlayTimes;
    private Integer praiseTimes;  //点赞字数
    private Long flowerAmount;    //鲜花数
    private Long giftAmount;      //礼物数
    private Integer commentTimes; //评论数
    private Integer shareTimes;   //站内分享数
    private Integer KSCSongID;    //曲库ID

</code></pre>
<h5>TuwenResult对象</h5>
<pre><code>    private Long tuwenId;               //图文Id

    private Long userId;                //用户Id

    private String nickName;        //用户昵称

    private String photo;           //用户头像

    private Short authType;         //认证类型 0未认证 大于是1是已认证

    private String authInfo;        //认证信息

    private Short vip;              //是否会员  1是 0否

    private Integer level;          //会员等级

    private String textInfo;            //图文信息

    private String location;            //位置

    private String address;

    private Short privateUpload;       //私密或公开，1为私密，0为否

    private Short state;               //图文状态，1为正常，0为删除

    private List&lt;TuwenImageResult&gt; imageInfo; //图片信息

    private Integer topicId;               //话题Id

    private String topicName;             //话题名称

    private String publishTimeStr;        //发布时间字符串

    private Integer commentNum;           //评论数

    private Integer praiseNum;            //点赞数

    private Integer shareNum;              //分享数

    private Integer relation;   //当前登录用户和分享人的关系 0没关系 1关注 2好友 3被关注，当relation=0或者3的时候显示关注按钮

    private Integer isPraised;

    private Short removeType;
</code></pre>
<h5>TuwenShareResult对象</h5>
<pre><code>    private Long shareId;    //分享Id

    private String content;  //分享内容

    private Long userId;            //评论人Id

    private String nickName;        //评论人昵称

    private String photo;           //评论人头像

    private Short authType;         //认证类型 0未认证 大于是1是已认证，具体信息看68001接口

    private String authInfo;        //认证信息

    private Short vip;              //是否会员  1是 0否

    private Integer level;         //会员等级

    private Long tuwenId;       //图文Id

    private TuwenResult tuwen;        //图文信息

    private Long createTime;    //分享时间

    private Integer relation;   //当前登录用户和分享人的关系 0没关系 1关注 2好友 3被关注，当relation=0或者3的时候显示关注按钮

    private Short status;       //状态

    private String sharePublishTimeStr;        //发布时间字符串

    private Integer commentNum;           //评论数

    private Integer praiseNum;            //点赞数

    private Integer isPraised;
</code></pre>
<h5>VvArticleResult对象</h5>
<pre><code>    private String author;   //作者名称

    private String photo1;      //作者头像

    private Integer followState = 0;    //关注状态,0为关注,1关注，2互相关注,3被关注

    private Short authType;           //认证类型

    private String topicName;           //话题名称

    private Long topicId;               //话题id

    private String articleTitle;        //文章标题

    private String coverPic;            //封面

    private Long articleId;             //文章id

    private Long userId;                //用户id

    private Long praiseCount;           //点赞数

    private Long commentCount;          //评论数

    private Long readCount;             //阅读数

    private String docUrl;              //分享链接

    private Long shareCount;            //分享数

    private Integer authStatus;        // &#39;0私密状态 1加密状态 2公开&#39;,

    private Integer checkstatus;       //文章审核状态 0:未审核 1:已审核通过 2:审核未通过  3:广告 4:二次编辑未审核&#39;

    private Integer state;              //&#39;2 编辑状态  1 发布状态   0 删除状态&#39;,

    private Date createTime;

    private Date updateTime;

    private String articleIdExt;        //外部id

    private Integer quality;            //&#39;是否加精 0 没有  1 已经加精&#39;,

    private Date publishTime;           //&#39;发布时间&#39;,

    private Short original;             //&#39;原创标记，0是非原创，1是原创&#39;,

    private Integer articlePicCount;    //&#39;文章内图片数量&#39;,

    private Long flowerCount;         // 鲜花总数

    private Long diamondCount;      //收礼总数

    private String formatTime;      //格式化时间

    private Integer likeState;      //点赞状态,0未点赞,1点赞
</code></pre>
<h3>28.28 图文-查询家族动态置顶</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/queryFamilyMomentsTop.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/queryFamilyMomentsTop.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>家族动态过滤类型</td><td>filterType</td><td>是</td><td>Short</td><td>&nbsp;</td><td>家族动态过滤类型 1只显示小视频，不传都显示</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>总条数</td><td>totalCount</td><td>是</td><td>int</td><td>1</td><td>总条数</td></tr><tr><td>结果集对象</td><td>familyMomentsList</td><td>是</td><td>int</td><td>1000</td><td>返回家族动态对象</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.29 图文-查看家族动态</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/queryFamilyMoments.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/queryFamilyMoments.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>家族ID</td><td>familyID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>家族ID</td></tr><tr><td>家族动态过滤类型</td><td>filterType</td><td>是</td><td>Short</td><td>&nbsp;</td><td>家族动态过滤类型 1只显示小视频，不传都显示</td></tr><tr><td>排序序号</td><td>sortNo</td><td>是</td><td>String</td><td>&nbsp;</td><td>分页用排序序号，每次取最后一个对象的sortNo</td></tr><tr><td>页码</td><td>pageSize</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>总条数</td><td>totalCount</td><td>是</td><td>int</td><td>1</td><td>总条数</td></tr><tr><td>结果集对象</td><td>familyMomentsList</td><td>是</td><td>int</td><td>1000</td><td>返回家族动态对象</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>FamilyMomentsResult对象</h5>
<pre><code>    private Long familyID;

    private Long objID;

    private Short objType;              //类型ID,1为作品，2为文章

    private Long userID;

    private String userName;

    private String userImage;

    private String userAuthInfo;

    private Short userAuthType;

    private Short userVip;

    private Short status;

    private Integer priority;           //置顶，1000为非置顶

    private Date createTime;

    private String createTimeFormatStr;

    private String sortNo;

    private FamilyWork familyWork;

    private FamilyCommentArticle vvArticle;

</code></pre>
<h5>FamilyWork对象</h5>
<pre><code>    private Long AVID;           //作品ID
    private String name;         //作品名称
    private String fileUrl;      //作品地址
    private Integer fileType;    //作品类型 4是视频 其他是音频
    private String description;  //作品描述
    private Long userID;         //用户ID
    private String nickName;     //昵称
    private String photo;        //头像
    private Integer isVip;       //是否会员 1是 0不是
    private Date createTime;     //发布时间
    private Integer playTimes;   //播放次数
    private Integer praiseTimes; //点赞次数
    private Long giftAmount;     //礼物数
    private Integer commentTimes;//评论数
    private Integer shareTimes;  //分享数
    private Integer priority;    //优先级 默认1000，小于1000是置顶
    private Long hot;            //热度值
    private Integer authType;    //认证类型 -1非 0普通 1明星 2音乐人
    private Integer exFileType;  //扩展类型 0独唱 1合唱 2发起合唱
    private String tag;          //家族成员标签
    private Integer chorusNum;   //合唱次数
    private Long flowerAmount;   //鲜花数
    private String frontCoverUrl;//作品封面（视频前几帧图片）
    private String cover;//音频作品封面
    private String semiUserPhoto;//发起合唱者的头像
    private Long semiUserID;     //半成品用户ID
    private String semiUserNickName;//发起合唱者的昵称

    private Integer activityId;      //活动ID
    private String activityName;    //活动名称
    private Integer topicId;         //话题ID
    private String topicName;       //话题名称
    private Integer isRecommend;    //是否推荐 1是 0否

</code></pre>
<h5>VvArticle对象</h5>
<pre><code>    // 家族ID
    private Long familyID;

    // 动态排序值
    private Integer priority;

    // 文章ID
    private Long articleId;

    // 文章标题
    private String articleTitle;

    // 封面URL
    private String coverPic;

    // 文章作者
    private Long userId;

    // 文章作者昵称
    private String nickName;

    // 最后发布时间
    private Date publishTime;

    // 阅读次数
    private Long readCount;

    // 发布时间格式化
    private String formatTime;

    // 文章是否加精 0没有 1已经加精
    private Integer quality;

    // 家族成员标签
    private String tag;

    //分享url
    private String docUrl;

    //外部id
    private String articleIdExt;

    //鲜花数
    private Long flowerCount;

    //礼物数
    private Long diamondCount;

    //评论数
    private Long commentCount;

    //点赞数
    private Long praiseCount;

    //分享数
    private Long shareCount;
    
       //话题id
        private Long topicId;
    
        //话题名称
        private String topicName;
    
        //点赞状态
        private Integer likeState = 0;  //点赞状态,0未点赞,1点赞
    
    
        private String shareCoverPic;
</code></pre>
<h3>28.30 图文-查看图文模板</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/wx/dynamic/' target='_blank' class='url'>https://music.51vv.com/wx/dynamic/</a>{dynamicType}/{dynamicId}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>对象ID</td><td>dynamicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>对象ID</td></tr><tr><td>对象类型</td><td>dynamicType</td><td>是</td><td>Short</td><td>&nbsp;</td><td>1为图文，2为分享图文</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文对象</td><td>tuwen</td><td>是</td><td>TuwenResult</td><td>&amp;npbs;</td><td>图文对象，参数dynamicType为1时返回</td></tr><tr><td>图文分享对象</td><td>tuwenShare</td><td>是</td><td>TuwenShareResult</td><td>&amp;npbs;</td><td>图文分享对象，参数dynamicType为2时返回</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h5>TuwenResult 对象</h5>
<pre><code>    private Long tuwenId;               //图文Id
    private Long userId;                //用户Id
    private String nickName;        //用户昵称
    private String photo;           //用户头像
    private Short authType;         //认证类型 0未认证 大于是1是已认证
    private String authInfo;        //认证信息
    private Short vip;              //是否会员  1是 0否
    private String textInfo;            //图文信息
    private String location;            //位置
    private String address;             //地址
    private Short privateUpload;       //私密或公开，1为私密，0为否
    private Short state;               //图文状态，1为正常，0为删除
    private List&lt;TuwenImageResult&gt; imageInfo; //图片信息
    private Integer topicId;               //话题Id
    private String topicName;             //话题名称
    private String publishTimeStr;        //发布时间字符串
    private Integer commentNum;           //评论数
    private Integer praiseNum;            //点赞数
    private Integer shareNum;              //分享数
    private Integer relation;   //当前登录用户和分享人的关系 0没关系 1关注 2好友 3被关注，当relation=0或者3的时候显示关注按钮
    private Integer isPraised;
    private Short removeType;   //当state=0的时候，区分删除类型 0用户删除 1系统删除

</code></pre>
<h3>28.31、图文-取消点赞评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/deletePraiseTuwenComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/deletePraiseTuwenComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文评论Id</td><td>commentId</td><td>是</td><td>long</td><td>&nbsp;</td><td>图文评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.32、图文-取消点赞分享评论</h3>
<h5>接口作者：温志广</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/tuwen/base/deletePraiseTuwenShareComment.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/base/deletePraiseTuwenShareComment.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>图文分享评论Id</td><td>shareCommentId</td><td>是</td><td>long</td><td>&nbsp;</td><td>图文分享评论Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>28.33 查询默认位置</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/locationByIP.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/locationByIP.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>位置信息列表</td><td>location</td><td>是</td><td>Location</td><td>&nbsp;</td><td>位置信息列表</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code>    {
        &quot;retCode&quot;:1000,
        &quot;location&quot;:{
            &quot;gpsx1&quot;:39.91488908,
            &quot;countryName&quot;:&quot;中国&quot;,
            &quot;street&quot;:&quot;&quot;,
            &quot;cityName&quot;:&quot;北京市&quot;,
            &quot;countryCode&quot;:&quot;0&quot;,
            &quot;gpsGetType&quot;:2,
            &quot;provinceName&quot;:&quot;北京市&quot;,
            &quot;district&quot;:&quot;&quot;,
            &quot;gpsy1&quot;:116.40387397,
            &quot;gpsGetFrom&quot;:0
        }
    }


</code></pre>
<h3>28.34 查询默认位置</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/tuwen/locationByIpParam.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/tuwen/locationByIpParam.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>ip地址</td><td>ip</td><td>是</td><td>String</td><td>&nbsp;</td><td>IP地址</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>位置信息列表</td><td>location</td><td>是</td><td>Location</td><td>&nbsp;</td><td>位置信息列表</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code>    {
        &quot;retCode&quot;:1000,
        &quot;location&quot;:{
            &quot;gpsx1&quot;:39.91488908,
            &quot;countryName&quot;:&quot;中国&quot;,
            &quot;street&quot;:&quot;&quot;,
            &quot;cityName&quot;:&quot;北京市&quot;,
            &quot;countryCode&quot;:&quot;0&quot;,
            &quot;gpsGetType&quot;:2,
            &quot;provinceName&quot;:&quot;北京市&quot;,
            &quot;district&quot;:&quot;&quot;,
            &quot;gpsy1&quot;:116.40387397,
            &quot;gpsGetFrom&quot;:0
        }
    }


</code></pre>
<h3>29.1、话题二期-选择话题-话题分类列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/chooseClassification.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/chooseClassification.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>选择话题发布的类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>选择话题时发布内容的类型 1作品 2图文 3文章 4MV</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>classifyList</td><td>否</td><td>TopicClassify</td><td>success</td><td>话题分类列表对象</td></tr></tbody>
</table></figure>
<h5>话题分类对象</h5>
<pre><code>    private Long classId;           //话题分类Id
    private String name;            //话题分类名称
    private Short classType;        //分类类型，1推荐，2最新，3其他
</code></pre>
<h3>29.2、话题二期-选择话题-话题列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/chooseTopic.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/chooseTopic.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr><tr><td>分类类型</td><td>classType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>分类类型， 1推荐, 2最新，3其他</td></tr><tr><td>选择话题分类Id</td><td>classId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>选择话题分类的Id</td></tr><tr><td>选择话题发布的类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>选择话题时发布内容的类型 1作品 2图文 3文章 4MV</td></tr><tr><td>歌曲Id</td><td>songId</td><td>否</td><td>Integer</td><td>&nbsp;</td><td>歌曲Id,从作品(歌曲)进来时传歌曲Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicList</td><td>否</td><td>Topic</td><td>success</td><td>推荐话题列表对象</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code>    private Integer isRecommendStyle;       //是否带红色&quot;荐&quot;字 1为带&quot;荐&quot;字，0为不带
    private Integer topicId;                //话题Id
    private String name;
    private String topicRuleDesc;           //话题规则描述
    private String topicDesc;               //话题规则描述
    private String bgImageUrl;              //背景图片url
    private String indexImageUrl;           //封面图片url
    private Short state;                    //状态 1 - 有效 0 - 无效
    private Short topFlag;                  //置顶 1 - 置顶
    private Integer topScore;               //置顶序号
    private Short topicType;
    private Long score;                     //热度
    private Long count;                     //参与人数
    private Short workFlag;                 //支持作品 1是 0否
    private Short articleFlag;              //支持文章 1是 0否
    private Short tuwenFlag;                //支持图文 1是 0否
    private Short mvFlag;                   //支持mv 1是 0否
    private Short recommendFlag;            //推荐话题 1是 0否
    private Date startTime;                 //开始征集时间
    private Date endTime;
    private Date recommendStartTime;        //推荐开始时间
    private Date recommendEndTime;
    private Date lastContentPublishTime;    //话题最后内容发布时间
    private Date createTime;
    private Date updateTime;
</code></pre>
<h3>29.3、话题二期-选择话题-搜索话题提示</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/chooseSearchTips.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/chooseSearchTips.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>选择话题发布的类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>选择话题时发布内容的类型 1作品 2图文 3文章 4MV</td></tr><tr><td>选择话题搜索词</td><td>searchWord</td><td>是</td><td>String</td><td>&nbsp;</td><td>选择话题搜索词</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicList</td><td>否</td><td>Topic</td><td>success</td><td>推荐话题列表对象</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code>    private Integer isRecommendStyle;       //是否带红色&quot;荐&quot;字 1为带&quot;荐&quot;字，0为不带
    private Integer topicId;                //话题Id
    private String name;
    private String topicRuleDesc;           //话题规则描述
    private String topicDesc;               //话题规则描述
    private String bgImageUrl;              //背景图片url
    private String indexImageUrl;           //封面图片url
    private Short state;                    //状态 1 - 有效 0 - 无效
    private Short topFlag;                  //置顶 1 - 置顶
    private Integer topScore;               //置顶序号
    private Short topicType;
    private Long score;                     //热度
    private Long count;                     //参与人数
    private Short workFlag;                 //支持作品 1是 0否
    private Short articleFlag;              //支持文章 1是 0否
    private Short tuwenFlag;                //支持图文 1是 0否
    private Short mvFlag;                   //支持mv 1是 0否
    private Short recommendFlag;            //推荐话题 1是 0否
    private Date startTime;                 //开始征集时间
    private Date endTime;
    private Date recommendStartTime;        //推荐开始时间
    private Date recommendEndTime;
    private Date lastContentPublishTime;    //话题最后内容发布时间
    private Date createTime;
    private Date updateTime;
</code></pre>
<h3>29.4、话题二期-选择话题-搜索话题</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/chooseSearch.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/chooseSearch.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>选择话题发布的类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>选择话题时发布内容的类型 1作品 2图文 3文章 4MV</td></tr><tr><td>选择话题搜索词</td><td>searchWord</td><td>是</td><td>String</td><td>&nbsp;</td><td>选择话题搜索词</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicList</td><td>否</td><td>Topic</td><td>success</td><td>推荐话题列表对象</td></tr></tbody>
</table></figure>
<h5>话题对象</h5>
<pre><code>    private Integer isRecommendStyle;       //是否带红色&quot;荐&quot;字 1为带&quot;荐&quot;字，0为不带
    private Integer topicId;                //话题Id
    private String name;
    private String topicRuleDesc;           //话题规则描述
    private String topicDesc;               //话题规则描述
    private String bgImageUrl;              //背景图片url
    private String indexImageUrl;           //封面图片url
    private Short state;                    //状态 1 - 有效 0 - 无效
    private Short topFlag;                  //置顶 1 - 置顶
    private Integer topScore;               //置顶序号
    private Short topicType;
    private Long score;                     //热度
    private Long count;                     //参与人数
    private Short workFlag;                 //支持作品 1是 0否
    private Short articleFlag;              //支持文章 1是 0否
    private Short tuwenFlag;                //支持图文 1是 0否
    private Short mvFlag;                   //支持mv 1是 0否
    private Short recommendFlag;            //推荐话题 1是 0否
    private Date startTime;                 //开始征集时间
    private Date endTime;
    private Date recommendStartTime;        //推荐开始时间
    private Date recommendEndTime;
    private Date lastContentPublishTime;    //话题最后内容发布时间
    private Date createTime;
    private Date updateTime;
</code></pre>
<h3>29.5、话题二期-话题主页-推荐话题作品首页</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/indexRecommend.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexRecommend.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h5>话题内容对象 TopicContentResult</h5>
<pre><code>    private Integer topicId;            //话题Id
    private Long contentId;             //作品Id 歌曲、图文、文章
    private Short type;                 //1-作品 2-图文 3-文章 4-视频
    private WorkResult workResult;      //作品对象-歌曲
    private TuwenResult tuwenResult;    //图文对象
    private VvArticle vvArticle;        //文章对象
</code></pre>
<h5>作品对象</h5>
<pre><code>    private Long avid;               //作品ID
    private String name;             //作品名称
    private String frontCoverUrl;    //封面图片Url
    private String description;      //描述
    private String originalDescription;
    private Short exFileType;      //扩展文件类型 扩展文件类型 0 独唱 1 合唱 2 发起合唱
    private Long semiAVID;           //发起合唱作品ID
    private Short status;          //作品状态
    private Short zpSource;        //作品来源 0 翻唱曲库 1 清唱 2 本地歌曲
    private String recordParams;     //录歌参数
    private Short privateUpload;   //是否私密上传 1是 0不是
    private Short isAccept;          //是否收录作品
    private Short webUpload;         //是否网页上传 1是 0不是
    private String hashCode;         //md5码
    private Short fileType;        //文件类型 1音频 4 视频
    private String fileURL;          //文件地址
    private String thumbUrl;         //缩略图
    private Float duration;          //时长
    private Float bitrate;           //码流（kb）
    private Long createTimeMills;  //创建时间
    private String createTimeByFormat; //格式化后的创建时间

    private Integer playTimes;       //播放次数
    private Integer praiseTimes;     //点赞次数
    private Integer isPraised;		//是否点赞
    private Integer shareTimes;      //分享次数
    private Integer commentTimes;    //评论次数
    private Integer collectTimes;    //收藏次数
    private Integer chorusNum;       //合唱次数
    private Long giftAmount;         //礼物数量
    private Long giftDiamond;        //礼物乐币数量
    private Integer flowerAmount;    //鲜花数量
    private Long redPacketAmount;   //红包数量

    private Long roomID;
    private String roomName;

    private Integer grade;
    private Long totalScore;
    private String cover;
    private Integer skipSecond;

    private Short goodVoice;           //好声音 1是 0否

    private String pendant;
    private String semiPendant;
    private String partnerPendant;

    private Short isReading = (short)0;

    private Integer activityId;      //活动ID
    private String activityName;    //活动名称

    private Integer topicId;         //话题
    private String topicName;        //话题名称

    private Integer kscSongID;       //曲库ID
    private String kscLink;          //字幕
    private String songSource;       //歌曲来源
    private String accompanyLink;    //伴奏ID
    private Integer artistID;        //歌手ID
    private String singerName;       //歌手名
    private Short vocalID;         //伴奏音轨
    private Short state;             //状态
    private Short accompaniment_state; //伴奏版权
    private Short original_state;      //原唱版权

    private Short isMID = (short)0;
    private String MIDUrl;
    private Short songState;

    private Long userID;             //用户ID
    private String nickName;           //用户昵称
    private String userPhoto;          //用户头像
    private String gender;             //用户性别
    private Short authType;          //认证类型  -1未认证 0普通用户 1明星 2音乐人
    private String authInfo;           //认证信息
    private Integer vip;               //是否会员  1是 0不是
    private Long level_singer;         //歌手等级
    private Integer relation;         //是否关注

    private Long semiUserID;           //发起合唱用户ID
    private String semiNickName;       //发起合唱用户昵称
    private String semiGender;         //发起合唱性别
    private String semiUserPhoto;      //发起合唱用户头像
    private Short semiAuthType;      //发起合唱用户认证类型  -1未认证 0普通用户 1明星 2音乐人
    private String semiAuthInfo;       //发起合唱用户认证信息
    private Integer semiVip;           //发起合唱用户是否会员  1是 0不是
    private Long semi_level_singer;    //发起合唱用户歌手等级

    private Long partnerUserID;        //合唱用户ID
    private String partnerNickName;    //合唱用户昵称
    private String partnerGender;      //合唱用户性别
    private String partnerUserPhoto;   //合唱用户头像
    private Short partnerAuthType;   //合唱认证类型  -1未认证 0普通用户 1明星 2音乐人
    private String partnerAuthInfo;    //合唱用户认证信息
    private Integer partnerVip;        //合唱用户是否会员  1是 0不是
    private Long partner_level_singer;  //合唱用户歌手等级
</code></pre>
<h5>图文对象</h5>
<pre><code>    private Long tuwenId;               //图文Id

    private Long userId;                //用户Id

    private String nickName;        //用户昵称

    private String photo;           //用户头像

    private Short authType;         //认证类型 0未认证 大于是1是已认证

    private String authInfo;        //认证信息

    private Short vip;              //是否会员  1是 0否

    private Integer level;          //会员等级

    private String textInfo;            //图文信息

    private String location;            //位置

    private String address;

    private Short privateUpload;       //私密或公开，1为私密，0为否

    private Short state;               //图文状态，1为正常，0为删除

    private List&lt;TuwenImageResult&gt; imageInfo; //图片信息

    private Integer topicId;               //话题Id

    private String topicName;             //话题名称

    private String publishTimeStr;        //发布时间字符串

    private Integer commentNum;           //评论数

    private Integer praiseNum;            //点赞数

    private Integer shareNum;              //分享数

    private Integer relation;   //当前登录用户和分享人的关系 0没关系 1关注 2好友 3被关注，当relation=0或者3的时候显示关注按钮

    private Integer isPraised;

    private Short removeType;
</code></pre>
<h5>文章对象</h5>
<pre><code>    private String author;   //作者名称

    private String photo1;      //作者头像

    private Integer followState = 0;    //关注状态,0为关注,1关注

    private Short authType;           //认证类型

    private String topicName;           //话题名称

    private Long topicId;               //话题id

    private String articleTitle;        //文章标题

    private String coverPic;            //封面

    private Long articleId;             //文章id

    private Long userId;                //用户id

    private Long praiseCount;           //点赞数

    private Long commentCount;          //评论数

    private Long readCount;             //阅读数

    private String docUrl;              //分享链接

    private Long shareCount;            //分享数

    private Integer authStatus;        // &#39;0私密状态 1加密状态 2公开&#39;,

    private Integer checkstatus;       //文章审核状态 0:未审核 1:已审核通过 2:审核未通过  3:广告 4:二次编辑未审核&#39;

    private Integer state;              //&#39;2 编辑状态  1 发布状态   0 删除状态&#39;,

    private Date createTime;

    private Date updateTime;

    private String articleIdExt;        //外部id

    private Integer quality;            //&#39;是否加精 0 没有  1 已经加精&#39;,

    private Date publishTime;           //&#39;发布时间&#39;,

    private Short original;             //&#39;原创标记，0是非原创，1是原创&#39;,

    private Integer articlePicCount;    //&#39;文章内图片数量&#39;,

    private Long flowerCount;         // 鲜花总数

    private Long diamondCount;      //收礼总数

    private String formatTime;      //格式化时间

    private Integer likeState = 0;  //点赞状态,0未点赞,1点赞
    
     private Integer vip;            //vip 0非vip，1vip
    
     private String shareCoverPic;  //分享带logo图
</code></pre>
<h3>29.6、话题二期-话题主页-推荐话题作品首页上拉/下拉</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/indexRecommendNext.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexRecommendNext.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>上拉/下拉</td><td>nextType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>上拉/下拉，1为上拉，2为下拉</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h3>29.7、话题二期-话题主页-精品话题作品</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/indexGood.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexGood.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h3>29.8、话题二期-话题主页-最新话题作品</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/indexLatest.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexLatest.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h3>29.9、话题二期-话题主页-作品(歌曲、图文、文章)列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/indexContent.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexContent.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>作品类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>作品类型，1为歌曲，2为图文，3为文章，4为视频</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h3>29.10、话题二期-话题主页-话题详情</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/indexDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>话题对象</td><td>topic</td><td>否</td><td>Topic</td><td>success</td><td>话题对象</td></tr></tbody>
</table></figure>
<h3>29.11、话题二期-话题广场-推荐话题列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/squareRecommend.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/squareRecommend.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicList</td><td>否</td><td>Topic</td><td>success</td><td>推荐话题列表对象</td></tr></tbody>
</table></figure>
<h3>29.12、话题二期-话题广场-话题作品列表首页</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/squareList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/squareList.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h3>29.13、话题二期-话题广场-话题作品列表下拉</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/squareListNext.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/squareListNext.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr><tr><td>类型</td><td>nextType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>1为上拉，2为下拉</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicContentResultList</td><td>否</td><td>TopicContentResult</td><td>success</td><td>话题作品对象</td></tr></tbody>
</table></figure>
<h3>29.14、话题二期-全部话题-话题分类列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/allClassification.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/allClassification.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>classifyList</td><td>否</td><td>TopicClassifyResult</td><td>success</td><td>话题分类列表对象</td></tr></tbody>
</table></figure>
<h3>29.15、话题二期-全部话题-话题列表</h3>
<h5>接口作者：李旭</h5>
<h5>接口链接</h5>
<p>URL链接 <a href='https://music.51vv.com/sodnew/topic/allTopic.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/allTopic.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr><tr><td>分类类型</td><td>classType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>分类类型， 1推荐, 2最新，3其他</td></tr><tr><td>话题分类Id</td><td>classId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题分类的Id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>列表对象</td><td>topicList</td><td>否</td><td>Topic</td><td>success</td><td>推荐话题列表对象</td></tr><tr><td>话题数量</td><td>topicListCount</td><td>否</td><td>Long</td><td>success</td><td>话题列表数量</td></tr></tbody>
</table></figure>
<h3>30.1 双旦活动，任务详情</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/bell/taskInfo.htm' target='_blank' class='url'>https://music.51vv.com/act/bell/taskInfo.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：success</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	isComment: 1,       	//评论作品    	0未完成 1已完成未领取 2已完成已领取
	isSign: 1,	        	//每日签到		0未完成 1已完成未领取 2已完成已领取
	userID: 900002773,
	isPublich: 1,			//公开发表作品	0未完成 1已完成未领取 2已完成已领取
	retCode: 1000,
	restBellNum: 9992,		//剩余铃铛数
	retMsg: &quot;成功&quot;,
	isWatchLive: 0,			//观看直播十分钟	0未完成 1已完成未领取 2已完成已领取
	isShareAv: 1,			//分享作品		0未完成 1已完成未领取 2已完成已领取
	isRoomSong: 1,			//歌房上麦3分钟	0未完成 1已完成未领取 2已完成已领取
	isRelationShow: 0,		//是否关联了VV秀
	restCjNum: 4996			//剩余可抽奖次数
}

</code></pre>
<h3>30.2 双旦活动，领取铃铛</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/bell/addBell.htm?taskID=20001' target='_blank' class='url'>https://music.51vv.com/act/bell/addBell.htm?taskID=20001</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>任务ID</td><td>taskID</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>任务ID</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: 1,			//成功：1。失败：0
	userID: 900002773,	//用户ID
	retCode: 1000,
	retMsg: &quot;成功&quot;,
    msg: &quot;success&quot;,		//完成或者未完成任务的描述
	taskID: 20001		//任务ID
}

</code></pre>
<h3>30.3 双旦活动，抽奖接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/bell/cjGift.htm' target='_blank' class='url'>https://music.51vv.com/act/bell/cjGift.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	result: 1,				//抽奖结果：1成功0失败
	userID: 900009916,		//用户ID
	retCode: 1000,
	retMsg: &quot;成功&quot;,
	giftNameList: [			//抽中奖品数组，第一个是VV音乐的奖品
	&quot;荧光棒*10个&quot;,
	&quot;58v点&quot;
	],
    giftIdList:[1,2]		//抽中奖品id数组，第一个是VV音乐的奖品
}

</code></pre>
<h3>30.4 双旦活动，奖励记录</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/bell/cjLog.htm' target='_blank' class='url'>https://music.51vv.com/act/bell/cjLog.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>页长</td><td>viewNumber</td><td>是</td><td>Integer</td><td>10</td><td>每页的长度</td></tr><tr><td>页码</td><td>curPage</td><td>是</td><td>Integer</td><td>1</td><td>当前页码</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
	mapList: [
		{
			createTime: 1575441596000,	//创建时间
			userID: 900002773,			//用户ID
			giftName: &quot;鲜花*188朵&quot;,		//奖品名称
 	        giftType:1					//vvShow的用户
		},
		{
			createTime: 1575441595000,
			userID: 900002773,
			giftName: &quot;鼠年大吉*10个&quot;,
   			giftType:0					//vv音乐的用户
		}
	],
	retCode: 1000,
	retMsg: &quot;成功&quot;
}

</code></pre>
<p>&nbsp;</p>
<h3>31.1 情人节活动-获取直播间数据</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getLiveRoomDataFromQingRenJie.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getLiveRoomDataFromQingRenJie.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行</td><td>anchorRank</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>当前炮弹等级</td><td>boxLevel</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>宝箱是否升级</td><td>upgrade</td><td>是</td><td>int</td><td>&nbsp;</td><td>宝箱是否升级 true 升级 false 未升级（升级显示宝箱特效）</td></tr><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>活动是否开始</td><td>isEnd</td><td>是</td><td>int</td><td>&nbsp;</td><td>0 未开始 1 进行中 2 已结束</td></tr><tr><td>当前时间</td><td>nowTime</td><td>是</td><td>Long</td><td>&nbsp;</td><td>时间戳</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<h3>31.2 情人节活动-甜蜜榜 日榜/总榜</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getAnchorListFormQingRenJie.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getAnchorListFormQingRenJie.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>&nbsp;</td><td>1 日榜 2 总榜</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>送礼最多用户信息</td><td>userMap</td><td>是</td><td>Map</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>userMap返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3>31.3 情人节活动-真爱榜 日榜/总榜</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getUserListFormQingRenJie.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserListFormQingRenJie.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>&nbsp;</td><td>1 日榜 2 总榜</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<h3>31.4 情人节活动-真爱上一小时前三名</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getUserTop3FormQingRenJie.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserTop3FormQingRenJie.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<h3>31.5 情人节活动-甜蜜上一小时前三名</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getAnchorTop3FormQingRenJie.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getAnchorTop3FormQingRenJie.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<h3>31.6 情人节活动-抢炮弹</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getAnchorBoxGift.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getAnchorBoxGift.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>是否抢到礼物</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>1已抢到 0 未抢到 2 已抢过</td></tr><tr><td>抢到的礼物数量</td><td>giftCount</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<h3>31.7 情人节活动-获取我的日/总甜蜜值</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getMyHotValue.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getMyHotValue.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>type</td><td>是</td><td>int</td><td>&nbsp;</td><td>1 日榜 2 总榜</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播Map</td><td>resultMap</td><td>是</td><td>list</td><td>&nbsp;</td><td>null表示不是特效礼物主播</td></tr></tbody>
</table></figure>
<h4>resultMap返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3>32.1 通过主播idList获取直播信息</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getOpenIngLiveInfoByAnchorIDs.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getOpenIngLiveInfoByAnchorIDs.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播idList</td><td>anchorIds</td><td>是</td><td>String</td><td>anchorIds=900009060,900009007,900009033</td><td>最多查询100个</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>直播信息List</td><td>liveInfoList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>直播信息模型 LiveInfo</h5>
<pre><code>private Long liveID;          //直播ID
private Long userID;          //用户ID
private String nickName;      //用户昵称
private String description;   //房间描述
private Short state;          //房间状态 0直播未开始  1直播中   2直播关闭  3回看中   4  删除   5回看生成中   6回看生成失败
private Long onlineCount;     //在线人数
private String photo;         //用户头像

private Short gender;         //性别.1男 2女
private String position;      //直播位置
private String province;      //省份
private String videoUrl;      //录像地址
private String shareUrl;      //分享地址
private Short type;           //直播类型,0表示公开直播,1表示私密直播
private Long watchedCount;    //观看过的人数
private String streamUrl;     //流媒体观看地址
private String shareCard;     //直播IDbase
private Short videoType;      //视频类型.0表示9:16,1表示4:3,2表示16:9

private String coverImg;      //封面
private Integer coverPos;     //封面的位置 1左 2右
</code></pre>
<pre><code>{
	&quot;retCode&quot;: 1000,
	&quot;retMsg&quot;: &quot;成功&quot;,
	&quot;liveInfoList&quot;: [{
		&quot;mediaID&quot;: 1102,
		&quot;pushStreamUrl&quot;: &quot;.&quot;,
		&quot;hotRank&quot;: 0.0,
		&quot;type&quot;: 0,
		&quot;city&quot;: &quot;火星&quot;,
		&quot;startTime&quot;: 1578274458000,
		&quot;watchedCount&quot;: 188,
		&quot;description&quot;: &quot;1&quot;,
		&quot;province&quot;: &quot;其他&quot;,
		&quot;pageNumber&quot;: 1,
		&quot;gender&quot;: 1,
		&quot;maxOnlineCount&quot;: 6,
		&quot;liveType&quot;: 1,
		&quot;topic&quot;: &quot;&quot;,
		&quot;videoConfig&quot;: &quot;{\&quot;videoEncoderParam\&quot;:{\&quot;isRealTimeEncode\&quot;:1,\&quot;captureFrameRate\&quot;:20,\&quot;captureWidth\&quot;:1280,\&quot;captureHeight\&quot;:720,\&quot;videoWidth\&quot;:360,\&quot;videoHeight\&quot;:640,\&quot;bitrate\&quot;:1200,\&quot;maxBitrate\&quot;:1500,\&quot;averateBitrate\&quot;:1200,\&quot;encodeFrameRate\&quot;:15,\&quot;minBitrate\&quot;:500,\&quot;gop\&quot;:1,\&quot;quality\&quot;:0.9,\&quot;minFrameRate\&quot;:12,\&quot;use_x264_encoder\&quot;:0,\&quot;x264_ext_params\&quot;:\&quot;i_frame_reference=2;i_qp_min=0;i_qp_max=40;f_ip_factor=1.4;f_pb_factor=0\&quot;},\&quot;audioEncoderParam\&quot;:{\&quot;aacObjectType\&quot;:1,\&quot;sampleRate\&quot;:44100,\&quot;bitrate\&quot;:64,\&quot;use_sys_enc\&quot;:1},\&quot;uniVideoEncodeParam\&quot;:{\&quot;isRealTimeEncode\&quot;:1,\&quot;encodeFrameRate\&quot;:15,\&quot;captureWidth\&quot;:1280,\&quot;videoHeight\&quot;:640,\&quot;minFrameRate\&quot;:12,\&quot;quality\&quot;:0.9,\&quot;gop\&quot;:1,\&quot;averateBitrate\&quot;:800,\&quot;bitrate\&quot;:800,\&quot;videoWidth\&quot;:360,\&quot;maxBitrate\&quot;:1200,\&quot;captureFrameRate\&quot;:15,\&quot;minBitrate\&quot;:300,\&quot;captureHeight\&quot;:720,\&quot;use_x264_encoder\&quot;:\&quot;0\&quot;,\&quot;x264_ext_params\&quot;:\&quot;i_frame_reference=1;i_qp_min=0;i_qp_max=60;f_ip_factor=1.4;f_pb_factor=0\&quot;,\&quot;videoWidth_4_3\&quot;:512,\&quot;videoHeight_4_3\&quot;:384,\&quot;videoWidth_16_9\&quot;:640,\&quot;videoHeight_16_9\&quot;:352},\&quot;uniAudioEncoderParam\&quot;:{\&quot;aacObjectType\&quot;:1,\&quot;sampleRate\&quot;:44100,\&quot;bitrate\&quot;:64}}&quot;,
		&quot;updateTime&quot;: 1578370350000,
		&quot;videoUrl&quot;: &quot;&quot;,
		&quot;mobileOSVer&quot;: &quot;Windows 7&quot;,
		&quot;property&quot;: 0,
		&quot;scheduleUpdateTime&quot;: 1578370350000,
		&quot;videoType&quot;: 1,
		&quot;country&quot;: &quot;火星&quot;,
		&quot;roomID&quot;: 36139,
		&quot;shareUrl&quot;: &quot;https://music.51vv.com/wx/s/?liveid=12049389&amp;uid=900009060&quot;,
		&quot;replayCount&quot;: 0,
		&quot;isImportantMonitor&quot;: 0,
		&quot;position&quot;: &quot;火星&quot;,
		&quot;createTime&quot;: 1578274455000,
		&quot;recordNumber&quot;: 0,
		&quot;sort&quot;: &quot;desc&quot;,
		&quot;startNumber&quot;: 0,
		&quot;liveID&quot;: 12049389,
		&quot;cdnStreamUrl&quot;: &quot;http://ws.downflv.m.51vv.com/live/mcu_12049389.flv&quot;,
		&quot;state&quot;: 1,
		&quot;platForm&quot;: &quot;vvmusic-windows&quot;,
		&quot;viewNumber&quot;: 20,
		&quot;coverImgUrl&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/04/03/180403174852696e53c9faa9444e.jpg&quot;,
		&quot;order&quot;: &quot;&quot;,
		&quot;videoUrlH5&quot;: &quot;&quot;,
		&quot;curPage&quot;: 1,
		&quot;isLastNew&quot;: 1,
		&quot;clientVer&quot;: &quot;99.0.0.518&quot;,
		&quot;streamUrl&quot;: &quot;http://ws.downflv.m.51vv.com/live/mcu_12049389.flv&quot;,
		&quot;receiverTicketCount&quot;: 5809856,
		&quot;isHot&quot;: 1,
		&quot;onlineCount&quot;: 2,
		&quot;pushStreamType&quot;: &quot;1&quot;,
		&quot;maxOnlineDistinctCount&quot;: 0,
		&quot;property02&quot;: 0.0000,
		&quot;userID&quot;: 900009060,
		&quot;isShow&quot;: 1
	}]
}

</code></pre>
<h3>33.1 听一听，获取歌曲列表接口</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/listen/info/listenAvList.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/listen/info/listenAvList.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>返回作品里列表</td><td>result</td><td>是</td><td>List</td><td>&nbsp;</td><td>key是歌曲顺序，value是歌曲avId</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
    &quot;result&quot;: [
        {
            &quot;1&quot;: 123324
        },
        {
            &quot;2&quot;: 34535
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;retMsg&quot;: &quot;success&quot;
}

</code></pre>
<h3>33.2 听一听，查询听一听任务详情</h3>
<h5>接口作者：陈越</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/listen/info/listenTaskInfo.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/listen/info/listenTaskInfo.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
    &quot;finishTask&quot;: 1,	//任务是否已经完成：-1还没开始做任务，0未完成，1已完成
    &quot;retCode&quot;: 1000,
    &quot;songCount&quot;: 10,	//听了多少首听一听的歌曲
    &quot;taskDesc&quot;: &quot;听20首歌，听够15分钟，可得100朵鲜花&quot;,	//标题描述
    &quot;retMsg&quot;: &quot;success&quot;,
    &quot;listenTime&quot;: 800	//听了多少秒听一听的歌曲。单位秒。
}

</code></pre>
<h3>34.1 心动520活动-获取直播间数据</h3>
<h5>接口作者：刘冰</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/act/activity/getLiveRoomDataFromActive520.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getLiveRoomDataFromActive520.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>anchorID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播id</td></tr><tr><td>直播id</td><td>liveId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>直播id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>1000 成功 其他失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>处理成功</td><td>处理成功/操作失败</td></tr><tr><td>返回结果</td><td>anchorRank</td><td>是</td><td>int</td><td>&nbsp;</td><td>主播排行</td></tr><tr><td>返回结果</td><td>anchorHotValue</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播经验值</td></tr><tr><td>返回结果</td><td>userId</td><td>否</td><td>int</td><td>&nbsp;</td><td>用户id</td></tr><tr><td>返回结果</td><td>userName</td><td>否</td><td>String</td><td>&nbsp;</td><td>用户昵称</td></tr><tr><td>返回结果</td><td>userImg</td><td>否</td><td>String</td><td>&nbsp;</td><td>用户头像</td></tr><tr><td>返回结果</td><td>userHotValue</td><td>是</td><td>Long</td><td>&nbsp;</td><td>用户经验值</td></tr><tr><td>返回结果</td><td>anchorNowHotValue</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播现有经验值</td></tr><tr><td>返回结果</td><td>anchorAllHotValue</td><td>是</td><td>Long</td><td>&nbsp;</td><td>主播总经验值</td></tr><tr><td>返回结果</td><td>longTime</td><td>是</td><td>Long</td><td>&nbsp;</td><td>倒计时时间</td></tr><tr><td>返回结果</td><td>isEnd</td><td>是</td><td>int</td><td>&nbsp;</td><td>0 活动未开始 1活动正在进行 2 活动已结束</td></tr></tbody>
</table></figure>
<h5>返回JSON格式数据，如：</h5>
<pre><code>
</code></pre>
<p>&nbsp;</p>
<h3>34.2 心动520活动-心动榜（日榜）</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getAnchorDayListFormActive520.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getAnchorDayListFormActive520.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>dateNum</td><td>是</td><td>int</td><td>06</td><td>2020-05-06</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<h3>34.3 心动520活动-追爱榜 日榜</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getUserDayListFormActive520.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserDayListFormActive520.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>类型</td><td>dateNum</td><td>是</td><td>int</td><td>06</td><td>2020-05-06</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>主播id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3>34.4 心动520活动-心动榜(总榜)</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getAnchorAllListFormActive520.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getAnchorAllListFormActive520.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<h3>34.5 心动520活动-追爱榜(总榜)</h3>
<h5>接口作者：刘冰</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/act/activity/getUserAllListFormActive520.htm' target='_blank' class='url'>https://music.51vv.com/act/activity/getUserAllListFormActive520.htm</a></p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>主播排行list</td><td>resultList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>resultList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>objectId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>甜蜜值</td><td>hotValue</td><td>是</td><td>int</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户名称</td><td>userName</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>用户头像</td><td>userImg</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>111

</code></pre>
<h3>35.1 给新注册用户推荐关注用户</h3>
<h5>接口作者：陈越</h5>
<h5>是否鉴权：是</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/activity/popup/frontRecommendUsers.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/activity/popup/frontRecommendUsers.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr></tbody>
</table></figure>
<h5>返回模型</h5>
<pre><code>{
    &quot;mapList&quot;: [
        {
            &quot;photo1&quot;: &quot;http://upcdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/07/16/180716144818c269a57f6cdd42fd.jpg&quot;,//用户头像
            &quot;nickName&quot;: &quot;CY_大西瓜&quot;,//昵称
            &quot;userId&quot;: 900002773,
            &quot;fanCount&quot;: 45,//粉丝数
            &quot;gender&quot;: &quot;M&quot;,//性别，M是男F是女
            &quot;recommendReason&quot;: &quot;1&quot;//推荐理由
        }
    ],
    &quot;retCode&quot;: 1000,
    &quot;userId&quot;: 900002773,//当前登录人id
    &quot;retMsg&quot;: &quot;success&quot;
}
</code></pre>
<h3>36.1、话题三期-增加浏览数</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/topic/power/addTopicBrowseCount.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/power/addTopicBrowseCount.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>作品类型，1为歌曲，2为图文，3为文章</td></tr><tr><td>作品id</td><td>contentId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>作品id，1为歌曲id，2为图文id，3为文章id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>36.2、话题三期-话题主持人加精取消加精</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/topic/power/setQuality.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/power/setQuality.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>作品类型</td><td>contentType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>作品类型，1为歌曲，2为图文，3为文章</td></tr><tr><td>作品id</td><td>contentId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>作品id，1为歌曲id，2为图文id，3为文章id</td></tr><tr><td>操作类型</td><td>qualityType</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>0取消加精 1加精</td></tr><tr><td>话题id</td><td>topicId</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>话题id</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<h3>36.3、话题三期-话题详情页（修改老接口）</h3>
<h5>接口作者：胡明政</h5>
<h5>接口链接</h5>
<p><a href='https://music.51vv.com/sodnew/topic/indexDetail.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/topic/indexDetail.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>话题Id</td><td>topicId</td><td>是</td><td>Long</td><td>&nbsp;</td><td>话题Id</td></tr><tr><td>第几页</td><td>curPage</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>第几页</td></tr><tr><td>每页大小</td><td>viewNumber</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>每页大小</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,见返回码表</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String(128)</td><td>success</td><td>参数格式错误</td></tr><tr><td>话题对象</td><td>topic</td><td>否</td><td>Topic</td><td>success</td><td>话题对象</td></tr><tr><td>主持人信息</td><td>hostUser</td><td>否</td><td>HostUser</td><td>success</td><td>主持人信息</td></tr><tr><td>礼物列表</td><td>giftList</td><td>否</td><td>GiftList</td><td>success</td><td>礼物列表</td></tr></tbody>
</table></figure>
<h4>Topic 新增字段</h4>
<pre><code>private String giftUrl;				//奖励详情链接
private String ruleUrl;				//规则详情链接
private String hostUrl;				//主持人详情链接
</code></pre>
<h4>hostUser</h4>
<pre><code>&quot;wealthScore&quot;:371469,
&quot;photo1&quot;:&quot;http://chuangshicdn.file.m.mvbox.cn/upload/mobile/userPhoto/18/08/20/180820181849ab04eb20406a4079.jpg&quot;,
&quot;score&quot;:5147,
&quot;singerScore&quot;:676723,
&quot;vip&quot;:0,
&quot;userID&quot;:900009903,
&quot;wealthLevel&quot;:9,
&quot;level&quot;:14,
&quot;nickName&quot;:&quot;Tina&quot;,        
&quot;singerLevel&quot;:30,
&quot;description&quot;:&quot;&quot;,
&quot;gender&quot;:&quot;F&quot;,
&quot;authType&quot;:0
</code></pre>
<h4>giftList</h4>
<pre><code>endTime						//结束时间 毫秒
giftName					//礼物名称
giftCover					//礼物封面
</code></pre>
<h3>37.1 获取小视频任务详情列表</h3>
<h5>接口作者：陈越</h5>
<h5>是否鉴权：是</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/user/task/getVideoTask.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/getVideoTask.htm?parameter=</a>{&quot;type&quot;:1}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>详情列表的类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>1代表是普通用户的详情，2代表的是小视频红人的详情</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：1000</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>10天任务列表</td><td>taskList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>当前的月份</td><td>currentMonth</td><td>是</td><td>int</td><td>9</td><td>返回当前的月份</td></tr><tr><td>本月的小视频任务是否全部完成</td><td>isFinish</td><td>是</td><td>int</td><td>&nbsp;</td><td>0未完成1已完成</td></tr><tr><td>本月已完成几天任务</td><td>size</td><td>是</td><td>int</td><td>&nbsp;</td><td>例如：2</td></tr></tbody>
</table></figure>
<h4>taskList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>用户id</td><td>userID</td><td>是</td><td>Long</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>做任务的月份</td><td>taskDate</td><td>是</td><td>int</td><td>&nbsp;</td><td>例如：202010</td></tr><tr><td>第几次任务</td><td>no</td><td>是</td><td>int</td><td>&nbsp;</td><td>例如：1</td></tr><tr><td>普通用户的领奖状态</td><td>state</td><td>是</td><td>int</td><td>&nbsp;</td><td>0不可领取，1可领取，2已领取</td></tr><tr><td>小视频红人的领奖状态</td><td>redState</td><td>是</td><td>int</td><td>&nbsp;</td><td>0不可领取，1可领取，2已领取</td></tr></tbody>
</table></figure>
<h3>37.2 领取小视频任务的奖励</h3>
<h5>接口作者：陈越</h5>
<h5>是否鉴权：是</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/user/task/acceptTaskGift.htm?parameter=' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/acceptTaskGift.htm?parameter=</a>{&quot;type&quot;:1,&quot;no&quot;:1}</p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>领奖的类型</td><td>type</td><td>是</td><td>Integer</td><td>&nbsp;</td><td>1普通用户领奖2小视频红人领奖</td></tr><tr><td>第几次领奖</td><td>no</td><td>是</td><td>int</td><td>&nbsp;</td><td>例如1</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：成功 代表领奖成功 非1000的都是领奖失败</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>奖品列表</td><td>giftList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>giftList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>奖品类型</td><td>giftType</td><td>是</td><td>int</td><td>&nbsp;</td><td>1鲜花2道具3推荐卡</td></tr><tr><td>奖品图片地址</td><td>img</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>奖品数量描述</td><td>count</td><td>是</td><td>String</td><td>&nbsp;</td><td>例如：X36</td></tr><tr><td>奖品描述</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>例如：鲜花、小视频推荐卡</td></tr></tbody>
</table></figure>
<h3>37.3 判断当前用户是否小视频红人认证</h3>
<h5>接口作者：陈越</h5>
<h5>是否鉴权：是</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/user/task/getVideoRedAuth.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/getVideoRedAuth.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：成功</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>是否是小视频红人</td><td>result</td><td>是</td><td>int</td><td>&nbsp;</td><td>0不是，1是</td></tr><tr><td>文案类型</td><td>tipType</td><td>是</td><td>int</td><td>&nbsp;</td><td>1显示第一种文案，2显示第二种文案，0前端不用处理</td></tr><tr><td>是否显示入口</td><td>isShow</td><td>是</td><td>int</td><td>&nbsp;</td><td>0不显示1显示</td></tr></tbody>
</table></figure>
<h3>37.4 预览奖品</h3>
<h5>接口作者：陈越</h5>
<h5>是否鉴权：是</h5>
<h5>接口示例链接</h5>
<p><a href='https://music.51vv.com/sodnew/user/task/previewGift.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/user/task/previewGift.htm</a></p>
<h4>请求参数</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>第几天</td><td>no</td><td>是</td><td>int</td><td>&nbsp;</td><td>例如1</td></tr></tbody>
</table></figure>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>返回结果描述</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>操作成功：成功</td></tr><tr><td>返回结果描述</td><td>retMsg</td><td>是</td><td>String</td><td>success</td><td>操作成功：成功</td></tr><tr><td>奖品列表</td><td>giftList</td><td>是</td><td>list</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody>
</table></figure>
<h4>giftList返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>奖品类型</td><td>giftType</td><td>是</td><td>int</td><td>&nbsp;</td><td>1鲜花2道具3推荐卡</td></tr><tr><td>奖品图片地址</td><td>img</td><td>是</td><td>String</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td>奖品数量描述</td><td>count</td><td>是</td><td>String</td><td>&nbsp;</td><td>例如：X36</td></tr><tr><td>奖品描述</td><td>name</td><td>是</td><td>String</td><td>&nbsp;</td><td>例如：鲜花、小视频推荐卡</td></tr></tbody>
</table></figure>
<h3>38.1 首页推荐入口配置</h3>
<h5>接口作者：宋加彬</h5>
<h5>接口链接</h5>
<p>URL地址：<a href='https://music.51vv.com/sodnew/family/member/selectHomePageConfig.htm' target='_blank' class='url'>https://music.51vv.com/sodnew/family/member/selectHomePageConfig.htm</a></p>
<h4>请求参数</h4>
<p>字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述
------- | -------| -------| -------| -------| -------| -------</p>
<p>&nbsp;</p>
<h4>返回结果</h4>
<figure><table>
<thead>
<tr><th>字段名</th><th>变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead>
<tbody><tr><td>位置信息列表</td><td>location</td><td>是</td><td>Location</td><td>&nbsp;</td><td>位置信息列表</td></tr><tr><td>返回结果</td><td>retCode</td><td>是</td><td>int</td><td>1000</td><td>返回结果值,1000:成功</td></tr><tr><td>返回信息</td><td>retMsg</td><td>否</td><td>String</td><td>success</td><td>参数格式错误</td></tr></tbody>
</table></figure>
<pre><code>    {
	&quot;retCode&quot;: 1000,
	&quot;location&quot;: [{
		&quot;homeId&quot;: 1,
		&quot;name&quot;: &quot;MV&quot;,
		&quot;picUrl&quot;: &quot;http://1.jpg&quot;,
		&quot;value&quot;: {
			&quot;content&quot;: &quot;&quot;,
			&quot;title&quot;: &quot;VV音乐&quot;,
			&quot;param&quot;: &quot;&quot;,
			&quot;evt&quot;: &quot;12&quot;,
			&quot;type&quot;: &quot;31&quot;
		}
	}, {
		&quot;homeId&quot;: 2,
		&quot;name&quot;: &quot;专辑&quot;,
		&quot;picUrl&quot;: &quot;http://1.jpg&quot;,
		&quot;value&quot;: {
			&quot;content&quot;: &quot;&quot;,
			&quot;title&quot;: &quot;VV音乐&quot;,
			&quot;param&quot;: &quot;&quot;,
			&quot;evt&quot;: &quot;12&quot;,
			&quot;type&quot;: &quot;34&quot;
		}
	}, {
		&quot;homeId&quot;: 3,
		&quot;name&quot;: &quot;活动&quot;,
		&quot;picUrl&quot;: &quot;http://1.jpg&quot;,
		&quot;value&quot;: {}
	}, {
		&quot;homeId&quot;: 4,
		&quot;name&quot;: &quot;家族&quot;,
		&quot;picUrl&quot;: &quot;http://1.jpg&quot;,
		&quot;value&quot;:  {
			&quot;content&quot;: &quot;&quot;,
			&quot;title&quot;: &quot;VV音乐&quot;,
			&quot;param&quot;: &quot;&quot;,
			&quot;evt&quot;: &quot;12&quot;,
			&quot;type&quot;: &quot;35&quot;
		}
	}]
}

</code></pre>
<p>&nbsp;</p>
</body>
</html>